feature: Add a MapVariableValueProvider and move existing NONE provid…

…er to an object

src/main/kotlin/com/noxcrew/smp/SMP.kt

@@ -1,6 +1,7 @@
 package com.noxcrew.smp
 
 import com.noxcrew.smp.SMP.Companion.create
+import com.noxcrew.smp.provider.NoOpVariableValueProvider
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.Job
@@ -46,7 +47,7 @@ public interface SMP {
          * @since 1.0
          */
         public fun create(
-            variableValueProvider: VariableValueProvider = VariableValueProvider.NONE,
+            variableValueProvider: VariableValueProvider = NoOpVariableValueProvider,
             scopeFactory: () -> CoroutineScope = { CoroutineScope(Job() + Dispatchers.Default) },
         ): SMP {
             return Parser(variableValueProvider, scopeFactory)

src/main/kotlin/com/noxcrew/smp/VariableValueProvider.kt

@@ -16,6 +16,14 @@ public fun interface VariableValueProvider {
          *
          * @since 1.0
          */
+        @Deprecated(
+            message = "Moved to an object",
+            replaceWith =
+                ReplaceWith(
+                    expression = "NoOpVariableValueProvider",
+                    imports = ["com.noxcrew.smp.provider.NoOpVariableValueProvider"],
+                ),
+        )
         public val NONE: VariableValueProvider =
             VariableValueProvider {
                 throw UnsupportedOperationException("Variables are not supported in this parser!")

src/main/kotlin/com/noxcrew/smp/provider/MapVariableValueProvider.kt

@@ -0,0 +1,21 @@
+package com.noxcrew.smp.provider
+
+import com.noxcrew.smp.VariableValueProvider
+
+/**
+ * A variable value provider that is backed by a map.
+ *
+ * If a value is not present in the map for a given key, an exception will be thrown
+ * as this implementation uses [getValue]. If you wish to avoid this, consider creating
+ * the backing map using [withDefault].
+ *
+ * @property backingMap The backing map
+ * @since 1.1
+ */
+public data class MapVariableValueProvider(
+    public val backingMap: Map<String, Double>,
+) : VariableValueProvider {
+    override suspend fun getValue(name: String): Double {
+        return backingMap.getValue(name)
+    }
+}

src/main/kotlin/com/noxcrew/smp/provider/NoOpVariableValueProvider.kt

@@ -0,0 +1,14 @@
+package com.noxcrew.smp.provider
+
+import com.noxcrew.smp.VariableValueProvider
+
+/**
+ * A value provider that throws [UnsupportedOperationException] for all calls.
+ *
+ * @since 1.1
+ */
+public data object NoOpVariableValueProvider : VariableValueProvider {
+    override suspend fun getValue(name: String): Double {
+        throw UnsupportedOperationException("Variables are not supported in this parser!")
+    }
+}