remove deprecated APIs (#606)

50 files changed, 64 insertions, 2647 deletions

diff --git a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
index 0a6e5758..4a61f9ae 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
@@ -17,12 +17,6 @@ namespace StardewModdingAPI
         /// <summary>The patch version for backwards-compatible bug fixes.</summary>
         int PatchVersion { get; }
 
-#if !SMAPI_3_0_STRICT
-        /// <summary>An optional build tag.</summary>
-        [Obsolete("Use " + nameof(ISemanticVersion.PrereleaseTag) + " instead")]
-        string Build { get; }
-#endif
-
         /// <summary>An optional prerelease tag.</summary>
         string PrereleaseTag { get; }
 
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index ba9ca6c6..78b4c007 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -42,15 +42,6 @@ namespace StardewModdingAPI.Toolkit
         /// <summary>An optional prerelease tag.</summary>
         public string PrereleaseTag { get; }
 
-#if !SMAPI_3_0_STRICT
-        /// <summary>An optional prerelease tag.</summary>
-        [Obsolete("Use " + nameof(ISemanticVersion.PrereleaseTag) + " instead")]
-        public string Build => this.PrereleaseTag;
-
-        /// <summary>Whether the version was parsed from the legacy object format.</summary>
-        public bool IsLegacyFormat { get; }
-#endif
-
 
         /*********
         ** Public methods
@@ -60,20 +51,12 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="minor">The minor version incremented for backwards-compatible changes.</param>
         /// <param name="patch">The patch version for backwards-compatible fixes.</param>
         /// <param name="prereleaseTag">An optional prerelease tag.</param>
-        /// <param name="isLegacyFormat">Whether the version was parsed from the legacy object format.</param>
-        public SemanticVersion(int major, int minor, int patch, string prereleaseTag = null
-#if !SMAPI_3_0_STRICT
-            , bool isLegacyFormat = false
-#endif
-        )
+        public SemanticVersion(int major, int minor, int patch, string prereleaseTag = null)
         {
             this.MajorVersion = major;
             this.MinorVersion = minor;
             this.PatchVersion = patch;
             this.PrereleaseTag = this.GetNormalisedTag(prereleaseTag);
-#if !SMAPI_3_0_STRICT
-            this.IsLegacyFormat = isLegacyFormat;
-#endif
 
             this.AssertValid();
         }
diff --git a/src/SMAPI.Toolkit/Serialisation/Converters/SemanticVersionConverter.cs b/src/SMAPI.Toolkit/Serialisation/Converters/SemanticVersionConverter.cs
index aca06849..c50de4db 100644
--- a/src/SMAPI.Toolkit/Serialisation/Converters/SemanticVersionConverter.cs
+++ b/src/SMAPI.Toolkit/Serialisation/Converters/SemanticVersionConverter.cs
@@ -67,20 +67,8 @@ namespace StardewModdingAPI.Toolkit.Serialisation.Converters
             int minor = obj.ValueIgnoreCase<int>(nameof(ISemanticVersion.MinorVersion));
             int patch = obj.ValueIgnoreCase<int>(nameof(ISemanticVersion.PatchVersion));
             string prereleaseTag = obj.ValueIgnoreCase<string>(nameof(ISemanticVersion.PrereleaseTag));
-#if !SMAPI_3_0_STRICT
-            if (string.IsNullOrWhiteSpace(prereleaseTag))
-            {
-                prereleaseTag = obj.ValueIgnoreCase<string>("Build");
-                if (prereleaseTag == "0")
-                    prereleaseTag = null; // '0' from incorrect examples in old SMAPI documentation
-            }
-#endif
 
-            return new SemanticVersion(major, minor, patch, prereleaseTag
-#if !SMAPI_3_0_STRICT
-                , isLegacyFormat: true
-#endif
-            );
+            return new SemanticVersion(major, minor, patch, prereleaseTag);
         }
 
         /// <summary>Read a JSON string.</summary>
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 9d686e2f..736a10ea 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -44,32 +44,10 @@ namespace StardewModdingAPI
         public static string SavesPath { get; } = Path.Combine(Constants.DataPath, "Saves");
 
         /// <summary>The name of the current save folder (if save info is available, regardless of whether the save file exists yet).</summary>
-        public static string SaveFolderName
-        {
-            get
-            {
-                return Constants.GetSaveFolderName()
-#if SMAPI_3_0_STRICT
-                    ;
-#else
-                    ?? "";
-#endif
-            }
-        }
+        public static string SaveFolderName => Constants.GetSaveFolderName();
 
         /// <summary>The absolute path to the current save folder (if save info is available and the save file exists).</summary>
-        public static string CurrentSavePath
-        {
-            get
-            {
-                return Constants.GetSaveFolderPathIfExists()
-#if SMAPI_3_0_STRICT
-                    ;
-#else
-                    ?? "";
-#endif
-            }
-        }
+        public static string CurrentSavePath => Constants.GetSaveFolderPathIfExists();
 
         /****
         ** Internal
diff --git a/src/SMAPI/Events/ContentEvents.cs b/src/SMAPI/Events/ContentEvents.cs
deleted file mode 100644
index aca76ef7..00000000
--- a/src/SMAPI/Events/ContentEvents.cs
+++ /dev/null
@@ -1,45 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using StardewModdingAPI.Framework;
-using StardewModdingAPI.Framework.Events;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Events raised when the game loads content.</summary>
-    [Obsolete("Use " + nameof(Mod.Helper) + "." + nameof(IModHelper.Events) + " instead. See https://smapi.io/3.0 for more info.")]
-    public static class ContentEvents
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The core event manager.</summary>
-        private static EventManager EventManager;
-
-
-        /*********
-        ** Events
-        *********/
-        /// <summary>Raised after the content language changes.</summary>
-        public static event EventHandler<EventArgsValueChanged<string>> AfterLocaleChanged
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ContentEvents.EventManager.Legacy_LocaleChanged.Add(value);
-            }
-            remove => ContentEvents.EventManager.Legacy_LocaleChanged.Remove(value);
-        }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Initialise the events.</summary>
-        /// <param name="eventManager">The core event manager.</param>
-        internal static void Init(EventManager eventManager)
-        {
-            ContentEvents.EventManager = eventManager;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/ControlEvents.cs b/src/SMAPI/Events/ControlEvents.cs
deleted file mode 100644
index 45aedc9b..00000000
--- a/src/SMAPI/Events/ControlEvents.cs
+++ /dev/null
@@ -1,123 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using Microsoft.Xna.Framework.Input;
-using StardewModdingAPI.Framework;
-using StardewModdingAPI.Framework.Events;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Events raised when the player uses a controller, keyboard, or mouse.</summary>
-    [Obsolete("Use " + nameof(Mod.Helper) + "." + nameof(IModHelper.Events) + " instead. See https://smapi.io/3.0 for more info.")]
-    public static class ControlEvents
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The core event manager.</summary>
-        private static EventManager EventManager;
-
-
-        /*********
-        ** Events
-        *********/
-        /// <summary>Raised when the <see cref="KeyboardState"/> changes. That happens when the player presses or releases a key.</summary>
-        public static event EventHandler<EventArgsKeyboardStateChanged> KeyboardChanged
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_KeyboardChanged.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_KeyboardChanged.Remove(value);
-        }
-
-        /// <summary>Raised after the player presses a keyboard key.</summary>
-        public static event EventHandler<EventArgsKeyPressed> KeyPressed
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_KeyPressed.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_KeyPressed.Remove(value);
-        }
-
-        /// <summary>Raised after the player releases a keyboard key.</summary>
-        public static event EventHandler<EventArgsKeyPressed> KeyReleased
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_KeyReleased.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_KeyReleased.Remove(value);
-        }
-
-        /// <summary>Raised when the <see cref="MouseState"/> changes. That happens when the player moves the mouse, scrolls the mouse wheel, or presses/releases a button.</summary>
-        public static event EventHandler<EventArgsMouseStateChanged> MouseChanged
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_MouseChanged.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_MouseChanged.Remove(value);
-        }
-
-        /// <summary>The player pressed a controller button. This event isn't raised for trigger buttons.</summary>
-        public static event EventHandler<EventArgsControllerButtonPressed> ControllerButtonPressed
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_ControllerButtonPressed.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_ControllerButtonPressed.Remove(value);
-        }
-
-        /// <summary>The player released a controller button. This event isn't raised for trigger buttons.</summary>
-        public static event EventHandler<EventArgsControllerButtonReleased> ControllerButtonReleased
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_ControllerButtonReleased.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_ControllerButtonReleased.Remove(value);
-        }
-
-        /// <summary>The player pressed a controller trigger button.</summary>
-        public static event EventHandler<EventArgsControllerTriggerPressed> ControllerTriggerPressed
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_ControllerTriggerPressed.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_ControllerTriggerPressed.Remove(value);
-        }
-
-        /// <summary>The player released a controller trigger button.</summary>
-        public static event EventHandler<EventArgsControllerTriggerReleased> ControllerTriggerReleased
-        {
-            add
-            {
-                SCore.DeprecationManager.WarnForOldEvents();
-                ControlEvents.EventManager.Legacy_ControllerTriggerReleased.Add(value);
-            }
-            remove => ControlEvents.EventManager.Legacy_ControllerTriggerReleased.Remove(value);
-        }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Initialise the events.</summary>
-        /// <param name="eventManager">The core event manager.</param>
-        internal static void Init(EventManager eventManager)
-        {
-            ControlEvents.EventManager = eventManager;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsClickableMenuChanged.cs b/src/SMAPI/Events/EventArgsClickableMenuChanged.cs
deleted file mode 100644
index a0b903b7..00000000
--- a/src/SMAPI/Events/EventArgsClickableMenuChanged.cs
+++ /dev/null
@@ -1,33 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using StardewValley.Menus;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments for a <see cref="MenuEvents.MenuChanged"/> event.</summary>
-    public class EventArgsClickableMenuChanged : EventArgs
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The previous menu.</summary>
-        public IClickableMenu NewMenu { get; }
-
-        /// <summary>The current menu.</summary>
-        public IClickableMenu PriorMenu { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="priorMenu">The previous menu.</param>
-        /// <param name="newMenu">The current menu.</param>
-        public EventArgsClickableMenuChanged(IClickableMenu priorMenu, IClickableMenu newMenu)
-        {
-            this.NewMenu = newMenu;
-            this.PriorMenu = priorMenu;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsClickableMenuClosed.cs b/src/SMAPI/Events/EventArgsClickableMenuClosed.cs
deleted file mode 100644
index 77db69ea..00000000
--- a/src/SMAPI/Events/EventArgsClickableMenuClosed.cs
+++ /dev/null
@@ -1,28 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using StardewValley.Menus;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments for a <see cref="MenuEvents.MenuClosed"/> event.</summary>
-    public class EventArgsClickableMenuClosed : EventArgs
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The menu that was closed.</summary>
-        public IClickableMenu PriorMenu { get; }
-
-
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="priorMenu">The menu that was closed.</param>
-        public EventArgsClickableMenuClosed(IClickableMenu priorMenu)
-        {
-            this.PriorMenu = priorMenu;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsControllerButtonPressed.cs b/src/SMAPI/Events/EventArgsControllerButtonPressed.cs
deleted file mode 100644
index 949446e1..00000000
--- a/src/SMAPI/Events/EventArgsControllerButtonPressed.cs
+++ /dev/null
@@ -1,34 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using Microsoft.Xna.Framework;
-using Microsoft.Xna.Framework.Input;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments for a <see cref="ControlEvents.ControllerButtonPressed"/> event.</summary>
-    public class EventArgsControllerButtonPressed : EventArgs
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The player who pressed the button.</summary>
-        public PlayerIndex PlayerIndex { get; }
-
-        /// <summary>The controller button that was pressed.</summary>
-        public Buttons ButtonPressed { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="playerIndex">The player who pressed the button.</param>
-        /// <param name="button">The controller button that was pressed.</param>
-        public EventArgsControllerButtonPressed(PlayerIndex playerIndex, Buttons button)
-        {
-            this.PlayerIndex = playerIndex;
-            this.ButtonPressed = button;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsControllerButtonReleased.cs b/src/SMAPI/Events/EventArgsControllerButtonReleased.cs
deleted file mode 100644
index d6d6d840..00000000
--- a/src/SMAPI/Events/EventArgsControllerButtonReleased.cs
+++ /dev/null
@@ -1,34 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using Microsoft.Xna.Framework;
-using Microsoft.Xna.Framework.Input;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments for a <see cref="ControlEvents.ControllerButtonReleased"/> event.</summary>
-    public class EventArgsControllerButtonReleased : EventArgs
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The player who pressed the button.</summary>
-        public PlayerIndex PlayerIndex { get; }
-
-        /// <summary>The controller button that was pressed.</summary>
-        public Buttons ButtonReleased { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="playerIndex">The player who pressed the button.</param>
-        /// <param name="button">The controller button that was released.</param>
-        public EventArgsControllerButtonReleased(PlayerIndex playerIndex, Buttons button)
-        {
-            this.PlayerIndex = playerIndex;
-            this.ButtonReleased = button;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsControllerTriggerPressed.cs b/src/SMAPI/Events/EventArgsControllerTriggerPressed.cs
deleted file mode 100644
index 33be2fa3..00000000
--- a/src/SMAPI/Events/EventArgsControllerTriggerPressed.cs
+++ /dev/null
@@ -1,39 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using Microsoft.Xna.Framework;
-using Microsoft.Xna.Framework.Input;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments for a <see cref="ControlEvents.ControllerTriggerPressed"/> event.</summary>
-    public class EventArgsControllerTriggerPressed : EventArgs
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The player who pressed the button.</summary>
-        public PlayerIndex PlayerIndex { get; }
-
-        /// <summary>The controller button that was pressed.</summary>
-        public Buttons ButtonPressed { get; }
-
-        /// <summary>The current trigger value.</summary>
-        public float Value { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="playerIndex">The player who pressed the trigger button.</param>
-        /// <param name="button">The trigger button that was pressed.</param>
-        /// <param name="value">The current trigger value.</param>
-        public EventArgsControllerTriggerPressed(PlayerIndex playerIndex, Buttons button, float value)
-        {
-            this.PlayerIndex = playerIndex;
-            this.ButtonPressed = button;
-            this.Value = value;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsControllerTriggerReleased.cs b/src/SMAPI/Events/EventArgsControllerTriggerReleased.cs
deleted file mode 100644
index e90ff712..00000000
--- a/src/SMAPI/Events/EventArgsControllerTriggerReleased.cs
+++ /dev/null
@@ -1,39 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using Microsoft.Xna.Framework;
-using Microsoft.Xna.Framework.Input;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments for a <see cref="ControlEvents.ControllerTriggerReleased"/> event.</summary>
-    public class EventArgsControllerTriggerReleased : EventArgs
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The player who pressed the button.</summary>
-        public PlayerIndex PlayerIndex { get; }
-
-        /// <summary>The controller button that was released.</summary>
-        public Buttons ButtonReleased { get; }
-
-        /// <summary>The current trigger value.</summary>
-        public float Value { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="playerIndex">The player who pressed the trigger button.</param>
-        /// <param name="button">The trigger button that was released.</param>
-        /// <param name="value">The current trigger value.</param>
-        public EventArgsControllerTriggerReleased(PlayerIndex playerIndex, Buttons button, float value)
-        {
-            this.PlayerIndex = playerIndex;
-            this.ButtonReleased = button;
-            this.Value = value;
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Events/EventArgsInput.cs b/src/SMAPI/Events/EventArgsInput.cs
deleted file mode 100644
index 5cff3408..00000000
--- a/src/SMAPI/Events/EventArgsInput.cs
+++ /dev/null
@@ -1,64 +0,0 @@
-#if !SMAPI_3_0_STRICT
-using System;
-using System.Collections.Generic;
-
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Event arguments when a button is pressed or released.</summary>
-    public class EventArgsInput : EventArgs
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The buttons to suppress.</summary>
-        private readonly HashSet<SButton> SuppressButtons;
-
-
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The button on the controller, keyboard, or mouse.</summary>
-        public SButton Button { get; }
-
-        /// <summary>The current cursor position.</summary>
-        public ICursorPosition Cursor { get; }
-
-        /// <summary>Whether the input should trigger actions on the affected tile.</summary>
-        public bool IsActionButton => this.Button.IsActionButton();
-
-        /// <summary>Whether the input should use tools on the affected