make SER more friendly for AI

Author: Elektryk-Andrzej

Code/ArgumentSystem/Arguments/FloatArgument.cs

@@ -5,7 +5,6 @@
 using SER.Code.TokenSystem.Tokens;
 using SER.Code.TokenSystem.Tokens.ValueTokens;
 using SER.Code.ValueSystem;
-using Random = UnityEngine.Random;
 
 namespace SER.Code.ArgumentSystem.Arguments;
 
@@ -33,7 +32,7 @@ public override string InputDescription
             if (_minValue.HasValue && _maxValue.HasValue)
             {
                 return $"A number which is at least {_minValue} and most {_maxValue} e.g. " +
-                       $"{Math.Round(Random.Range(_minValue.Value, _maxValue.Value), 2)}";
+                       $"{Math.Round((double)new Random().Next((int)_minValue.Value, (int)_maxValue.Value + 1))}";
             }
 
             if (_minValue.HasValue)
@@ -44,7 +43,7 @@ public override string InputDescription
             // ReSharper disable once ConvertIfStatementToReturnStatement
             if (_maxValue.HasValue)
             {
-                return $"A number which is at most {_maxValue} e.g. {_maxValue - 2f}";
+                return $"A number which is at most {_maxValue} e.g. {_minValue + 2f}";
             }
 
             return "Any number e.g. 2.5";

Code/ArgumentSystem/ProvidedArguments.cs

@@ -1,4 +1,5 @@
 using LabApi.Features.Wrappers;
+using Respawning.Waves;
 using SER.Code.ArgumentSystem.Arguments;
 using SER.Code.ArgumentSystem.BaseArguments;
 using SER.Code.ArgumentSystem.Structures;
@@ -233,6 +234,11 @@ public Type GetEffectType(string argName)
         return GetValue<Type, EffectTypeArgument>(argName);
     }
 
+    public SpawnableWaveBase GetWaveType(string argName)
+    {
+        return GetValue<SpawnableWaveBase, WaveTypeArgument>(argName);
+    }
+
     public CollectionVariable GetCollectionVariable(string argName)
     {
         return GetValue<CollectionVariable, CollectionVariableArgument>(argName);

Code/ContextSystem/BaseContexts/LoopContext.cs

@@ -15,13 +15,13 @@ public abstract class LoopContext : StatementContext, IExtendableStatement, IKey
 
     protected abstract string? Usage { get; }
 
-    public string Example =>
-        $"""
-         {Usage}
-         
-         # ========================================
-         # "break" and "continue" keywords work as usual and you are free to use them inside "{KeywordName}" loops
-         """;
+    public string Example => SER.Code.Examples.Example.GetExample($"{KeywordName}KeywordExample") ??
+                             $"""
+                              {Usage}
+                              
+                              # ========================================
+                              # "break" and "continue" keywords work as usual and you are free to use them inside "{KeywordName}" loops
+                              """;
 
     protected bool ReceivedContinue;
     protected bool ReceivedBreak;

Code/ContextSystem/Contexter.cs

@@ -53,7 +53,7 @@ private static Result TryAddResult(
         Stack<StatementContext> statementStack, 
         List<RunnableContext> contexts
     ) {
-        Result rs = $"Invalid context {context}";
+        Result rs = $"Invalid {context}";
 
         Log.Debug($"Trying to add context {context}");
 

Code/ContextSystem/Contexts/Control/WaitKeyword.cs

@@ -21,15 +21,15 @@ public class WaitKeyword : YieldingContext, IKeywordContext
 
     public virtual string[] Arguments => ["<duration>"];
 
-    public virtual string? Example => 
-        """
-        # wait for 5 seconds
-        wait 5s
-        
-        # Waits using a variable
-        $duration = 10s
-        wait $duration
-        """;
+    public virtual string? Example => SER.Code.Examples.Example.GetExample($"{KeywordName}KeywordExample") ??
+                                      """
+                                      # wait for 5 seconds
+                                      wait 5s
+                                      
+                                      # Waits using a variable
+                                      $duration = 10s
+                                      wait $duration
+                                      """;
 
     public override string FriendlyName => $"'{KeywordName}' keyword";
 

Code/ContextSystem/Contexts/Control/WaitUntilKeyword.cs

@@ -20,11 +20,11 @@ public class WaitUntilKeyword : YieldingContext, IKeywordContext
 
     public virtual string[] Arguments => ["<condition...>"];
 
-    public virtual string? Example => 
-        """
-        # wait until there are no players on the server
-        wait_until {AmountOf @all} is 0
-        """;
+    public virtual string? Example => SER.Code.Examples.Example.GetExample($"{KeywordName}KeywordExample") ??
+                                      """
+                                      # wait until there are no players on the server
+                                      wait_until {AmountOf @all} is 0
+                                      """;
 
     public override string FriendlyName => $"'{KeywordName}' keyword";
 

Code/Examples/BreachScript.cs

@@ -1,4 +1,7 @@
-using System.Reflection;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Reflection;
 using JetBrains.Annotations;
 using SER.Code.ContextSystem.Interfaces;
 using SER.Code.Helpers.ResultSystem;
@@ -11,35 +14,48 @@ public abstract class Example
     public abstract string Name { get; }
     public abstract string Content { get; }
 
+    private static Dictionary<string, string>? _cachedExamples;
+
     [UsedImplicitly]
-    public static string Verify()
+    public static Dictionary<string, string> GetAllExamples()
     {
-        var examples = Assembly.GetExecutingAssembly().GetTypes()
-            .Where(t => !t.IsAbstract && typeof(Example).IsAssignableFrom(t))
-            .Select(Activator.CreateInstance)
-            .Cast<Example>()
-            .ToArray();
+        if (_cachedExamples != null) return _cachedExamples;
+        
+        var assembly = Assembly.GetExecutingAssembly();
+        var resourceNames = assembly.GetManifestResourceNames()
+            .Where(n => n.EndsWith(".ser"));
 
-        foreach (var example in examples)
+        var examples = new Dictionary<string, string>();
+        foreach (var name in resourceNames)
         {
-            if (Script.CreateAnonymous(example.Name, example.Content).Compile().HasErrored(out var error))
-            {
-                return new Result(false, $"in example '{example.Name}'") + error;
-            }
+            using var stream = assembly.GetManifestResourceStream(name);
+            if (stream == null) continue;
+            using var reader = new StreamReader(stream);
+            string content = reader.ReadToEnd();
+            string[] parts = name.Split('.');
+            if (parts.Length < 2) continue;
+            string fileName = parts[parts.Length - 2];
+            examples[fileName] = content;
         }
 
-        var keywords = Assembly.GetExecutingAssembly().GetTypes()
-            .Where(t => !t.IsAbstract && typeof(IKeywordContext).IsAssignableFrom(t))
-            .Select(Activator.CreateInstance)
-            .Cast<IKeywordContext>()
-            .Where(k => k.Example != null)
-            .ToArray();
-        
-        foreach (var keyword in keywords)
+        return _cachedExamples = examples;
+    }
+
+    public static string? GetExample(string name)
+    {
+        return GetAllExamples().TryGetValue(name, out var content) ? content : null;
+    }
+
+    [UsedImplicitly]
+    public static string Verify()
+    {
+        var examples = GetAllExamples();
+
+        foreach (var example in examples)
         {
-            if (Script.CreateAnonymous(keyword.KeywordName, keyword.Example!).Compile().HasErrored(out var error))
+            if (Script.CreateAnonymous(example.Key, example.Value).Compile().HasErrored(out var error))
             {
-                return new Result(false, $"in example of keyword '{keyword.KeywordName}'") + error;
+                return new Result(false, $"in example '{example.Key}'") + error;
             }
         }