add Translation method to disable gender-switch block handling

This allows for edge cases where a mod needs to keep gender-switch blocks as-is (e.g. to pass to dialogue later).

Author: Pathoschild

src/SMAPI/Translation.cs

@@ -33,6 +33,9 @@ public class Translation
     /// <summary>Whether to use <see cref="Placeholder"/> if the translation is <c>null</c> or empty.</summary>
     private bool ShouldUsePlaceholder { get; init; }
 
+    /// <summary>Whether to process gender-switch blocks in translation text, if any.</summary>
+    private bool ShouldApplyGenderSwitchBlocks { get; init; }
+
     /// <summary>The tokens to apply to the translation text, if any.</summary>
     private Dictionary<string, string?>? TokenValues { get; init; }
 
@@ -64,6 +67,7 @@ internal Translation(string locale, string key, string? text)
         this.Text = text;
         this.Placeholder = string.Format(Translation.PlaceholderText, key);
         this.ShouldUsePlaceholder = true;
+        this.ShouldApplyGenderSwitchBlocks = true;
     }
 
     /// <summary>Construct an instance.</summary>
@@ -73,6 +77,7 @@ internal Translation(Translation other)
     {
         this.Placeholder = other.Placeholder;
         this.ShouldUsePlaceholder = other.ShouldUsePlaceholder;
+        this.ShouldApplyGenderSwitchBlocks = other.ShouldApplyGenderSwitchBlocks;
         this.TokenValues = other.TokenValues;
         this.ForceGender = other.ForceGender;
     }
@@ -109,6 +114,20 @@ public Translation UsePlaceholder(bool use)
         };
     }
 
+    /// <summary>Whether to automatically process gender-switch blocks (i.e. <see cref="Dialogue.applyGenderSwitchBlocks"/>) before the text is returned.</summary>
+    /// <param name="apply">Whether to process gender-switch blocks.</param>
+    /// <remarks>Returns a new instance if this would change the result, else the current instance.</remarks>
+    public Translation ApplyGenderSwitchBlocks(bool apply)
+    {
+        if (this.ShouldApplyGenderSwitchBlocks == apply)
+            return this;
+
+        return new Translation(this)
+        {
+            ShouldApplyGenderSwitchBlocks = apply
+        };
+    }
+
     /// <summary>Replace tokens in the text like <c>{{value}}</c> with the given values.</summary>
     /// <param name="tokens">An object containing token key/value pairs. This can be an anonymous object (like <c>new { value = 42, name = "Cranberries" }</c>), a dictionary, or a class instance.</param>
     /// <exception cref="ArgumentNullException">The <paramref name="tokens"/> argument is <c>null</c>.</exception>