Add audio filepath completion helper

RELEASE-NOTES.md

@@ -39,7 +39,7 @@ END TEMPLATE-->
 
 ### New features
 
-*None yet*
+* Add a CompletionHelper for audio filepaths that handles server packaging.
 
 ### Bugfixes
 

Robust.Shared/Collections/ValueList.cs

@@ -607,4 +607,12 @@ public void EnsureLength(int newCount)
         region.Clear();
         Count = newCount;
     }
+
+    public void AddRange(IEnumerable<T> select)
+    {
+        foreach (var result in select)
+        {
+            Add(result);
+        }
+    }
 }

Robust.Shared/Console/CompletionHelper.cs

@@ -1,6 +1,8 @@
 using System.Collections.Generic;
 using System.Linq;
 using JetBrains.Annotations;
+using Robust.Shared.Audio;
+using Robust.Shared.Collections;
 using Robust.Shared.ContentPack;
 using Robust.Shared.GameObjects;
 using Robust.Shared.IoC;
@@ -23,6 +25,28 @@ public static class CompletionHelper
     public static IEnumerable<CompletionOption> Booleans => new[]
         { new CompletionOption(bool.FalseString), new CompletionOption(bool.TrueString) };
 
+    /// <summary>
+    /// Special-cased file handler for audio that accounts for serverside completion.
+    /// </summary>
+    public static IEnumerable<CompletionOption> AudioFilePath(string arg, IPrototypeManager protoManager,
+        IResourceManager res)
+    {
+        var results = new ValueList<CompletionOption>();
+
+        foreach (var proto in protoManager.EnumeratePrototypes<AudioMetadataPrototype>())
+        {
+            if (!proto.ID.StartsWith(arg))
+                continue;
+
+            results.Add(new CompletionOption(proto.ID));
+        }
+
+        results.AddRange(ContentFilePath(arg, res));
+        results.Sort();
+
+        return results;
+    }
+
     public static IEnumerable<CompletionOption> ContentFilePath(string arg, IResourceManager res)
     {
         var curPath = arg;

Robust.Shared/Console/CompletionResult.cs

@@ -38,7 +38,7 @@ private static CompletionOption[] ConvertOptions(IEnumerable<string> stringOpts)
 /// <summary>
 /// Possible option to tab-complete in a <see cref="CompletionResult"/>.
 /// </summary>
-public record struct CompletionOption(string Value, string? Hint = null, CompletionOptionFlags Flags = default)
+public record struct CompletionOption(string Value, string? Hint = null, CompletionOptionFlags Flags = default) : IComparable<CompletionOption>
 {
     /// <summary>
     /// The value that will be filled in if completed.
@@ -54,6 +54,12 @@ public record struct CompletionOption(string Value, string? Hint = null, Complet
     /// Flags that control how this completion is used.
     /// </summary>
     public CompletionOptionFlags Flags { get; set; } = Flags;
+
+    public int CompareTo(CompletionOption other)
+    {
+        var valueComparison = string.Compare(Value, other.Value, StringComparison.CurrentCultureIgnoreCase);
+        return valueComparison;
+    }
 }
 
 /// <summary>

Robust.Shared/ContentPack/ResourceManager.cs

@@ -177,14 +177,16 @@ public bool TryContentFileRead(string path, [NotNullWhen(true)] out Stream? file
         /// <inheritdoc />
         public bool TryContentFileRead(ResPath? path, [NotNullWhen(true)] out Stream? fileStream)
         {
+            fileStream = null;
+
             if (path == null)
             {
-                throw new ArgumentNullException(nameof(path));
+                return false;
             }
 
             if (!path.Value.IsRooted)
             {
-                throw new ArgumentException($"Path '{path}' must be rooted", nameof(path));
+                return false;
             }
 #if DEBUG
             if (!IsPathValid(path.Value))