1 files changed, 80 insertions, 69 deletions
diff --git a/core/src/Utils/I18n.hpp b/core/src/Utils/I18n.hpp
index de32cf8..a4dd225 100644
--- a/core/src/Utils/I18n.hpp
+++ b/core/src/Utils/I18n.hpp
@@ -1,69 +1,80 @@
-#pragma once
-
-#include "Utils/Sigslot.hpp"
-#include "Utils/fwd.hpp"
-
-#include <cstddef>
-#include <optional>
-#include <span>
-#include <string>
-#include <string_view>
-#include <variant>
-#include <vector>
-
-class I18n {
-public:
-	static void Init();
-	static void Shutdown();
-
-	static Signal<> OnReload;
-	static void ReloadLocales();
-
-	static std::string_view GetLanguage();
-	static bool SetLanguage(std::string_view lang);
-
-	static std::optional<std::string_view> Lookup(std::string_view key);
-	static std::string_view LookupUnwrap(std::string_view key);
-	static std::string_view LookupLanguage(std::string_view lang);
-};
-
-struct StringArgument {
-	std::string Value;
-};
-
-struct IntArgument {
-	int Value;
-};
-
-struct FloatArgument {
-	double Value;
-};
-
-class BasicTranslation {
-private:
-	const char* mContent;
-
-public:
-	BasicTranslation(std::string_view key);
-	const char* Get() const;
-};
-
-class FormattedTranslation {
-public:
-	using Element = std::variant<std::string, int>;
-	using Argument = std::string;
-
-private:
-	std::vector<Element> mParsedElements;
-	size_t mNumArguments;
-	size_t mMinimumResultLen;
-
-public:
-	FormattedTranslation(std::string_view key);
-	std::string Format(std::span<Argument> args);
-};
-
-class NumericTranslation {
-public:
-	// TODO
-};
+#pragma once
+
+#include "Utils/Sigslot.hpp"
+#include "Utils/fwd.hpp"
+
+#include <cstddef>
+#include <optional>
+#include <span>
+#include <string>
+#include <string_view>
+#include <variant>
+#include <vector>
+
+class I18n {
+public:
+	static inline Signal<> OnLanguageChange{};
+	static inline Signal<> OnUnload{};
+
+	static void Init();
+	static void Shutdown();
+
+	/// Discard in-memory mapping from key to locale entries.
+	/// When any of the entry accessors are invoked, unloaded entries will be reloaded.
+	static void Unload();
+
+	static std::string_view GetLanguage();
+	static bool SetLanguage(std::string_view lang);
+
+	/* Entry accessors */
+	/// Find the localized entry with the given key, return \c std::nullopt if does not exist. Reloads locale entries if they are currently unloaded.
+	static std::optional<std::string_view> Lookup(std::string_view key);
+	/// Find the localized entry with the given key, throw an exception if does not exist. EnsureLoaded locale entries if they are currently unloaded.
+	static std::string_view LookupUnwrap(std::string_view key);
+
+	/// Query the localized name of a locale, e.g. "en_US" -> "English - United States".
+	/// If the queried locale does not exist, an empty string will be returned (existing locales can never have an empty localized name).
+	static std::string_view LookupLanguage(std::string_view lang);
+};
+
+struct StringArgument {
+	std::string Value;
+};
+
+struct IntArgument {
+	int Value;
+};
+
+struct FloatArgument {
+	double Value;
+};
+
+class BasicTranslation {
+private:
+	std::string mContent;
+
+public:
+	BasicTranslation(std::string_view key);
+	const std::string& GetString() const;
+	const char* Get() const;
+};
+
+class FormattedTranslation {
+public:
+	using Element = std::variant<std::string, int>;
+	using Argument = std::string;
+
+private:
+	std::vector<Element> mParsedElements;
+	size_t mNumArguments;
+	size_t mMinimumResultLen;
+
+public:
+	FormattedTranslation(std::string_view key);
+	std::string Format(std::span<Argument> args);
+};
+
+class NumericTranslation {
+public:
+	// TODO
+};