Translation

public Translation();

Creates an owned empty catalog with Locale="en" and empty PluralRulesOverride. Does not register it with TranslationServer or change the project language. Dispose the resource after use.

public string Locale { get; set; }

Resource locale, default en. The setter standardizes its identifier and clears cached rules when no explicit override exists. Does not switch the global language, automatically retranslate existing UI text or emit Changed.

public Reckfell.Collections.Dictionary Messages { get; set; }

Internal storage Dictionary snapshot: Array key [context, srcMessage], nonempty Array value of form strings. The getter creates separate containers. The setter first clears the whole map, then copies entries; it also accepts a string key with one string value and no context. Neither a merge nor a complete resource format. Do not supply unchecked arrays: key length 2 is not fully validated. Emits no Changed; dispose the owned Dictionary after reading.

public string PluralRulesOverride { get; set; }

Explicit rules such as nplurals=2; plural=(n != 1);. Empty text selects Locale rules then the English fallback. The setter clears cached rules but changes no stored forms and emits no Changed. An invalid override can produce a diagnostic before fallback; this is not successful validation. Keep form count/order consistent with the rules.

public void AddMessage(StringName srcMessage, StringName xlatedMessage, StringName context = null);

Assigns one string to the exact (context, srcMessage) pair. Replaces an existing translation and all of its plural forms rather than adding only absent entries. An empty value is allowed but its lookup result is indistinguishable from a miss. Emits no Resource.Changed.

public void AddPluralMessage(StringName srcMessage, ReadOnlySpan<string> xlatedMessages, StringName context);

Replaces the exact (context, srcMessage) entry with a nonempty plural-form array. Form order must match Locale or PluralRulesOverride; the method infers no order from text and inserts no count. Empty input produces a diagnostic; form count is checked when selecting an index. Emits no Changed.

public void AddPluralMessage(StringName srcMessage, string[] xlatedMessages, StringName context = null);

Replaces the exact (context, srcMessage) entry with a nonempty plural-form array. Form order must match Locale or PluralRulesOverride; the method infers no order from text and inserts no count. Empty input produces a diagnostic; form count is checked when selecting an index. Emits no Changed.

public void EraseMessage(StringName srcMessage, StringName context = null);

Removes only the exact (context, srcMessage) pair including all its forms. A missing key is a no-op; the same source text under other contexts remains. Emits no Changed.

public string GetLocale();

Reads this resource standardized locale, not the current TranslationServer locale.

public StringName GetMessage(StringName srcMessage, StringName context = null);

Looks up the exact (context, srcMessage) pair in this resource and returns its first form. A miss yields an empty StringName rather than source text. Calls an overridden _GetMessage first; an empty callback result does not trigger base-map fallback. Applies no server fallback locale.

public int GetMessageCount();

Number of (context, srcMessage) pairs rather than all plural-form strings. Overridden by OptimizedTranslation to return 0 with a warning; not a compressed-lookup population test.

public string[] GetMessageList();

Returns an independent string[] of source keys: srcMessage without context or context+U+0004+srcMessage with context. Not sorted and not translated text; avoid U+0004 inside new keys. OptimizedTranslation retains no source keys and returns an empty array with a warning.

public StringName GetPluralMessage(StringName srcMessage, StringName srcPluralMessage, int n, StringName context = null);

For nonnegative n selects the (context, srcMessage) entry form using resource rules. srcPluralMessage is not part of base-map lookup but is forwarded to _GetPluralMessage. A miss yields an empty StringName; negative n or a missing selected form produces a diagnostic. Inserts no count and applies no global fallback locale. OptimizedTranslation does not select plural forms.

public string GetPluralRulesOverride();

Reads the stored override text rather than resolved effective locale rules. Empty text means no explicit override.

public string[] GetTranslatedMessageList();

Returns an independent string[] of stored translations including every plural form and empty value. Indices do not align with GetMessageList when entries have multiple forms; order is not sorted. For OptimizedTranslation lists compressed values without keys.

public void SetLocale(string locale);

Sets Locale with identifier normalization. Changes neither the global locale, messages nor an explicit PluralRulesOverride, and emits no Changed.

public void SetPluralRulesOverride(string rules);

Assigns PluralRulesOverride and clears cached rules. Empty text restores Locale-based rule selection. Converts no existing forms and emits no Changed.

public virtual StringName _GetMessage(StringName srcMessage, StringName context);

Override in a custom C# Translation class for direct lookup. GetMessage passes the exact key and context; the callback determines the entire result including misses. C# base._GetMessage is an empty stub rather than access to the native map. AddMessage and counts still operate on stored base entries.

public virtual StringName _GetPluralMessage(StringName srcMessage, StringName srcPluralMessage, int n, StringName context);

Override plural lookup in a custom Translation. Receives both source texts, n and context before base n validation. Define accepted input and misses yourself; an empty result does not enable base fallback. C# base._GetPluralMessage is an empty stub.