Util Extension

MiraAPI/GameOptions/Attributes/ModdedEnumOptionAttribute.cs

@@ -32,3 +32,33 @@ public override object GetValue()
             : throw new InvalidOperationException($"HolderOption for option \"{Title}\" with EnumType ${enumType.FullName} is not a ModdedEnumOption");
     }
 }
+
+/// <summary>
+/// Attribute for creating an enum option.
+/// </summary>
+/// <typeparam name="T">The enum type.</typeparam>
+[AttributeUsage(AttributeTargets.Property)]
+public class ModdedEnumOptionAttribute<T>(string title, string[]? values = null)
+    : ModdedOptionAttribute(title) where T : Enum
+{
+    internal override IModdedOption CreateOption(object? value, PropertyInfo property)
+    {
+        var opt = new ModdedEnumOption<T>(Title, (T)(value ?? 0), values);
+        return opt;
+    }
+
+    /// <inheritdoc />
+    public override void SetValue(object value)
+    {
+        var opt = HolderOption as ModdedEnumOption<T>;
+        opt?.SetValue((T)value);
+    }
+
+    /// <inheritdoc />
+    public override object GetValue()
+    {
+        return HolderOption is ModdedEnumOption<T> opt
+            ? opt.Value
+            : throw new InvalidOperationException($"HolderOption for option \"{Title}\" with EnumType ${typeof(T).FullName} is not a ModdedEnumOption");
+    }
+}

MiraAPI/GameOptions/Attributes/ModdedEnumOptionListAttribute.cs

@@ -0,0 +1,67 @@
+using MiraAPI.GameOptions.OptionTypes;
+using System;
+using System.Collections;
+using System.Reflection;
+
+namespace MiraAPI.GameOptions.Attributes;
+
+/// <summary>
+/// Attribute for creating a list of enum options.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public class ModdedEnumOptionListAttribute(Func<int, string> titler, Type enumType, string[]? values = null)
+    : ModdedOptionListAttribute(titler)
+{
+    internal override IModdedOptionList CreateOptionList(IList value, PropertyInfo property)
+    {
+        var optList = new ModdedOptionList<ModdedEnumOption>(
+            value.Count, idx => new(Titler(idx), (int)(value[idx] ?? 0), enumType, values));
+        return optList;
+    }
+
+    /// <inheritdoc />
+    public override void SetValue(int idx, object value)
+    {
+        var opt = HolderOptionList?[idx] as ModdedEnumOption;
+        opt?.SetValue((int)value);
+    }
+
+    /// <inheritdoc />
+    public override object GetValue(int idx)
+    {
+        return HolderOptionList?[idx] is ModdedEnumOption opt
+            ? Enum.ToObject(enumType, opt.Value)
+            : throw new InvalidOperationException($"HolderOption for option \"{Titler(idx)}\" with EnumType ${enumType.FullName} is not a ModdedEnumOption");
+    }
+}
+
+/// <summary>
+/// Attribute for creating a list of enum options.
+/// </summary>
+/// <typeparam name="T">The enum type.</typeparam>
+[AttributeUsage(AttributeTargets.Property)]
+public class ModdedEnumOptionListAttribute<T>(Func<int, string> titler, string[]? values = null)
+    : ModdedOptionListAttribute(titler) where T : Enum
+{
+    internal override IModdedOptionList CreateOptionList(IList value, PropertyInfo property)
+    {
+        var optList = new ModdedOptionList<ModdedEnumOption<T>>(
+            value.Count, idx => new(Titler(idx), (T)(value[idx] ?? 0), values));
+        return optList;
+    }
+
+    /// <inheritdoc />
+    public override void SetValue(int idx, object value)
+    {
+        var opt = HolderOptionList?[idx] as ModdedEnumOption<T>;
+        opt?.SetValue((T)value);
+    }
+
+    /// <inheritdoc />
+    public override object GetValue(int idx)
+    {
+        return HolderOptionList?[idx] is ModdedEnumOption<T> opt
+            ? opt.Value
+            : throw new InvalidOperationException($"HolderOption for option \"{Titler(idx)}\" with EnumType ${typeof(T).FullName} is not a ModdedEnumOption");
+    }
+}

MiraAPI/GameOptions/Attributes/ModdedNumberOptionListAttribute.cs

@@ -0,0 +1,55 @@
+using MiraAPI.GameOptions.OptionTypes;
+using MiraAPI.Utilities;
+using System;
+using System.Collections;
+using System.Reflection;
+
+namespace MiraAPI.GameOptions.Attributes;
+
+/// <summary>
+/// A number option attribute for the modded options system.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public class ModdedNumberOptionListAttribute(
+    Func<int, string> titler,
+    float min,
+    float max,
+    float increment = 1,
+    MiraNumberSuffixes suffixType = MiraNumberSuffixes.None,
+    string? formatString = null,
+    bool zeroInfinity = false)
+    : ModdedOptionListAttribute(titler)
+{
+    internal override IModdedOptionList CreateOptionList(IList value, PropertyInfo property)
+    {
+        return new ModdedOptionList<ModdedNumberOption>(value.Count, idx =>
+        {
+            return new(
+                Titler(idx),
+                (float)(value[idx] ?? min + increment),
+                min,
+                max,
+                increment,
+                suffixType,
+                formatString,
+                zeroInfinity);
+        });
+    }
+
+    /// <inheritdoc />
+    public override void SetValue(int idx, object value)
+    {
+        var opt = HolderOptionList?[idx] as ModdedNumberOption;
+        opt?.SetValue((float)value);
+    }
+
+    /// <inheritdoc />
+    public override object GetValue(int idx)
+    {
+        if (HolderOptionList?[idx] is ModdedNumberOption opt)
+        {
+            return opt.Value;
+        }
+        throw new InvalidOperationException($"HolderOption for option \"{Titler(idx)}\" is not a ModdedNumberOption");
+    }
+}

MiraAPI/GameOptions/Attributes/ModdedOptionAttribute.cs

@@ -9,31 +9,19 @@ namespace MiraAPI.GameOptions.Attributes;
 /// <param name="title">The option title.</param>
 /// <param name="roleType">Optional parameter to specify a role Type.</param>
 [AttributeUsage(AttributeTargets.Property)]
-public abstract class ModdedOptionAttribute(string title, Type? roleType = null) : Attribute
+public abstract class ModdedOptionAttribute(string title, Type? roleType = null) : PropertyOptionAttribute
 {
     internal IModdedOption? HolderOption { get; set; }
 
     /// <summary>
     /// Gets the title of the option.
     /// </summary>
-    public string Title { get; private set; } = title;
+    public string Title => title;
 
     /// <summary>
     /// Gets the role type of the option.
     /// </summary>
-    protected Type? RoleType { get; private set; } = roleType;
-
-    /// <summary>
-    /// Sets the value of the option.
-    /// </summary>
-    /// <param name="value">The new value as an object.</param>
-    public abstract void SetValue(object value);
-
-    /// <summary>
-    /// Gets the value of the option.
-    /// </summary>
-    /// <returns>The value of the option as an object.</returns>
-    public abstract object GetValue();
+    protected Type? RoleType => roleType;
 
     internal abstract IModdedOption? CreateOption(object? value, PropertyInfo property);
 }

MiraAPI/GameOptions/Attributes/ModdedOptionListAttribute.cs

@@ -0,0 +1,66 @@
+using System;
+using System.Collections;
+using System.Reflection;
+
+namespace MiraAPI.GameOptions.Attributes;
+
+/// <summary>
+/// Represents an attribute that is used to define a list of modded options.
+/// </summary>
+/// <param name="titler">A function to title of the options.</param>
+[AttributeUsage(AttributeTargets.Property)]
+public abstract class ModdedOptionListAttribute(Func<int, string> titler) : PropertyOptionAttribute
+{
+    internal IModdedOptionList? HolderOptionList { get; set; }
+
+    internal object? Value { get; set; }
+
+    /// <summary>
+    /// Gets the function to title of the options.
+    /// </summary>
+    public Func<int, string> Titler => titler;
+
+    /// <summary>
+    /// Sets the value of all the options.
+    /// </summary>
+    /// <param name="value">The new values as an object.</param>
+    public override void SetValue(object value)
+    {
+        Value = value;
+        var list = (IList)value;
+        if (list.Count != HolderOptionList!.Count)
+        {
+            throw new InvalidOperationException($"Value set to option list cannot change the list's length.");
+        }
+
+        for (int i = 0; i < list!.Count; i++)
+        {
+            SetValue(i, list[i]!);
+        }
+    }
+
+    /// <summary>
+    /// Sets the value of the specific option.
+    /// </summary>
+    /// <param name="idx">The option to set.</param>
+    /// <param name="value">The new value as an object.</param>
+    public abstract void SetValue(int idx, object value);
+
+    /// <summary>
+    /// Gets the value of all the options.
+    /// </summary>
+    /// <returns>The value of the options as an object.</returns>
+    public override object GetValue()
+    {
+        return Value!;
+    }
+
+    /// <summary>
+    /// Gets the value of the specific option.
+    /// </summary>
+    /// <param name="idx">The option to set.</param>
+    /// <returns>The value of the option as an object.</returns>
+    public abstract object GetValue(int idx);
+
+    internal abstract IModdedOptionList? CreateOptionList(IList value, PropertyInfo property);
+}

MiraAPI/GameOptions/Attributes/ModdedToggleOptionListAttribute.cs

@@ -0,0 +1,38 @@
+using MiraAPI.GameOptions.OptionTypes;
+using System;
+using System.Collections;
+using System.Reflection;
+
+namespace MiraAPI.GameOptions.Attributes;
+
+/// <summary>
+/// Attribute for a list of toggle options.
+/// </summary>
+/// <param name="titler">The function to get each option's title.</param>
+[AttributeUsage(AttributeTargets.Property)]
+public class ModdedToggleOptionListAttribute(Func<int, string> titler) : ModdedOptionListAttribute(titler)
+{
+    internal override IModdedOptionList CreateOptionList(IList value, PropertyInfo property)
+    {
+        var optList = new ModdedOptionList<ModdedToggleOption>(
+            value.Count, idx => new(Titler(idx), (bool)(value[idx] ?? false)));
+        return optList;
+    }
+
+    /// <inheritdoc />
+    public override void SetValue(int idx, object value)
+    {
+        var opt = HolderOptionList?[idx] as ModdedToggleOption;
+        opt?.SetValue((bool)value);
+    }
+
+    /// <inheritdoc />
+    public override object GetValue(int idx)
+    {
+        if (HolderOptionList?[idx] is ModdedToggleOption opt)
+        {
+            return opt.Value;
+        }
+        throw new InvalidOperationException($"Holder option for {Titler(idx)} is not a ModdedToggleOption.");
+    }
+}

MiraAPI/GameOptions/Attributes/PropertyOptionAttribute.cs

@@ -0,0 +1,22 @@
+using System;
+
+namespace MiraAPI.GameOptions.Attributes;
+
+/// <summary>
+/// Represents an attribute that is used to intercept a property's getter and setter.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public abstract class PropertyOptionAttribute : Attribute
+{
+    /// <summary>
+    /// Sets the value of the option.
+    /// </summary>
+    /// <param name="value">The new value as an object.</param>
+    public abstract void SetValue(object value);
+
+    /// <summary>
+    /// Gets the value of the option.
+    /// </summary>
+    /// <returns>The value of the option as an object.</returns>
+    public abstract object GetValue();
+}

MiraAPI/GameOptions/IModdedOption.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using BepInEx.Configuration;
 using MiraAPI.Networking;
 using MiraAPI.PluginLoading;
@@ -104,3 +105,10 @@ public interface IModdedOption
     /// <param name="presetConfig">The ConfigFile representing the preset configuration.</param>
     void LoadFromPreset(ConfigFile presetConfig);
 }
+
+/// <summary>
+/// Interface for list of modded options.
+/// </summary>
+public interface IModdedOptionList : IReadOnlyList<IModdedOption>
+{
+}