A Civilization-style strategy game about governing Israel from 15 May 1948. Real ministers, real map, every fact sourced. Unity + deterministic C# sim.
#nullable enable
using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Linq;
using YamlDotNet.Core;
using YamlDotNet.Serialization;
using YamlDotNet.Serialization.NamingConventions;
namespace Statecraft.Game.Map
{
/// <summary>Sourced presentation names, separate from generated geometry and its runtime cache.
/// A missing entry keeps the existing English field. New supplied names await the owner's native review; removing a flag is a human action.</summary>
public sealed class MapRegionNames
{
public const string FileName = "region_names_he.yaml";
readonly Dictionary<string, string> names = new Dictionary<string, string>(StringComparer.Ordinal);
readonly Dictionary<string, string> englishNames = new Dictionary<string, string>(StringComparer.Ordinal);
public string Pick(string key, string english, bool hebrew) =>
hebrew && names.TryGetValue(key, out var value) ? value : english;
sealed class Source
{
public string Url { get; set; } = "";
public string Checked { get; set; } = "";
public string Cite { get; set; } = "";
}
sealed class Entry
{
public string Key { get; set; } = "";
// English companion for the translation inventory; runtime fallback remains the original map field.
public string Name { get; set; } = "";
public string NameHe { get; set; } = "";
public List<Source> NameHeSources { get; set; } = new List<Source>();
bool reviewSpecified;
string? review;
public string? NameHeReview { get => review; set { review = value; reviewSpecified = true; } }
public bool ValidReview() => !reviewSpecified || review == "native-review-pending" || review == "agent-checked";
}
sealed class Doc { public List<Entry> Names { get; set; } = new List<Entry>(); }
public static MapRegionNames Parse(string yaml)
{
var result = new MapRegionNames();
if (string.IsNullOrWhiteSpace(yaml)) return result; // old bundles have no catalog
Doc? doc;
try { doc = new DeserializerBuilder().WithNamingConvention(UnderscoredNamingConvention.Instance)
.WithDuplicateKeyChecking().Build().Deserialize<Doc>(yaml); }
catch (YamlException e) { throw new InvalidDataException($"{FileName}: {e.Message}", e); }
if (doc?.Names == null) throw new InvalidDataException($"{FileName}: names is required");
foreach (var e in doc.Names)
{
if (e == null) throw new InvalidDataException($"{FileName}: null name row");
var field = $"{FileName}: names[{e.Key}]";
if (string.IsNullOrWhiteSpace(e.Key) || result.names.ContainsKey(e.Key))
throw new InvalidDataException($"{field}: missing or duplicate key");
if (string.IsNullOrWhiteSpace(e.NameHe) || !e.NameHe.Any(c => c >= '\u05d0' && c <= '\u05ea'))
throw new InvalidDataException($"{field}: name_he must contain Hebrew");
if (!e.ValidReview())
throw new InvalidDataException($"{field}: name_he_review must be native-review-pending or agent-checked, or omitted after human review");
if (e.NameHeSources == null || e.NameHeSources.Count == 0)
throw new InvalidDataException($"{field}: name_he_sources is required");
foreach (var source in e.NameHeSources)
if (source == null || !Uri.TryCreate(source.Url, UriKind.Absolute, out var url) || url.Scheme != "https"
|| !DateTime.TryParseExact(source.Checked, "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None, out _)
|| string.IsNullOrWhiteSpace(source.Cite))
throw new InvalidDataException($"{field}: name_he_sources needs an https URL, checked date and page/section citation");
result.names.Add(e.Key, e.NameHe);
result.englishNames.Add(e.Key, e.Name);
}
return result;
}
readonly List<string> stale = new List<string>();
/// <summary>Targets whose English companion no longer equals the live English field: they show that English instead.</summary>
public IReadOnlyList<string> Stale => stale;
/// <summary>Reject a misspelt target rather than silently dropping its name. A target under one of
/// <paramref name="absentPrefixes"/> belongs to a dataset this boot does not have (no armistice data): it is never shown, so it is not checked.
/// A target whose English companion no longer matches the live English is dropped, so the Hebrew never pairs with an outdated
/// English meaning; it shows the live English and is listed in <see cref="Stale"/>.</summary>
public void Validate(IEnumerable<KeyValuePair<string, string>> fields, params string[] absentPrefixes)
{
var allowed = new Dictionary<string, string>(fields, StringComparer.Ordinal);
foreach (var key in names.Keys.ToList())
{
if (!allowed.TryGetValue(key, out var english))
{
if (absentPrefixes.Any(p => key.StartsWith(p, StringComparison.Ordinal))) continue;
throw new InvalidDataException($"{FileName}: unknown target '{key}'");
}
if (string.Equals(englishNames[key], english, StringComparison.Ordinal)) continue;
names.Remove(key);
stale.Add(key);
}
}
}
}