[efficiency-improver] perf: add PropertyBag.FirstOrDefault(T)() to eliminate per-call array allocation

src/Platform/Microsoft.Testing.Extensions.VideoRecorder/VideoRecorderSessionHandler.cs

@@ -125,7 +125,7 @@ public Task ConsumeAsync(IDataProducer dataProducer, IData value, CancellationTo
 
         // A node carries a single state property in practice; use FirstOrDefault rather than
         // SingleOrDefault so a malformed producer can't throw out of the consumer pump.
-        TestNodeStateProperty? state = update.TestNode.Properties.OfType<TestNodeStateProperty>().FirstOrDefault();
+        TestNodeStateProperty? state = update.TestNode.Properties.FirstOrDefault<TestNodeStateProperty>();
         if (state is null)
         {
             return Task.CompletedTask;
@@ -477,7 +477,7 @@ private static bool OverlapsAnyFailedWindow(VideoSegment segment, double[] faile
 
     private (DateTimeOffset Start, DateTimeOffset End) ResolveTiming(TestNodeUpdateMessage update, string testUid)
     {
-        TimingProperty? timing = update.TestNode.Properties.OfType<TimingProperty>().FirstOrDefault();
+        TimingProperty? timing = update.TestNode.Properties.FirstOrDefault<TimingProperty>();
         if (timing is not null)
         {
             return (timing.GlobalTiming.StartTime, timing.GlobalTiming.EndTime);

src/Platform/Microsoft.Testing.Platform/Messages/PropertyBag.cs

@@ -213,6 +213,44 @@ public bool Any<TProperty>()
         return found;
     }
 
+    /// <summary>
+    /// Returns the first property of the <typeparamref name="TProperty"/> type, or <see langword="null"/> if none is found.
+    /// Unlike <see cref="SingleOrDefault{TProperty}"/>, this method does not throw when multiple properties of the
+    /// same type are present — it simply returns the first one encountered.
+    /// </summary>
+    /// <typeparam name="TProperty">The type of the property.</typeparam>
+    /// <returns>The first property of the given type, or <see langword="null"/> if none is found.</returns>
+    public TProperty? FirstOrDefault<TProperty>()
+        where TProperty : IProperty
+    {
+        if (_testNodeStateProperty is TProperty testNodeStateProperty)
+        {
+            return testNodeStateProperty;
+        }
+
+        // We don't want to walk the linked list if we know that we're looking for a TestNodeStateProperty.
+        if (typeof(TestNodeStateProperty).IsAssignableFrom(typeof(TProperty)))
+        {
+            return default;
+        }
+
+        // Direct linked-list walk: avoids the array allocation from OfType<T>() and the subsequent
+        // LINQ FirstOrDefault() call.  Early-returns on the first match so no duplicate tracking
+        // is needed (unlike SingleOrDefault<T>()).
+        Property? current = _property;
+        while (current is not null)
+        {
+            if (current.Current is TProperty match)
+            {
+                return match;
+            }
+
+            current = current.Next;
+        }
+
+        return default;
+    }
+
     /// <summary>
     /// Returns the only property of the <typeparamref name="TProperty"/> type, and throws an exception if there is not exactly one element.
     /// </summary>

src/Platform/Microsoft.Testing.Platform/PublicAPI/PublicAPI.Unshipped.txt

@@ -1,2 +1,3 @@
 #nullable enable
 [TPEXP]Microsoft.Testing.Platform.Extensions.IBlockingDataConsumer
+Microsoft.Testing.Platform.Extensions.Messages.PropertyBag.FirstOrDefault<TProperty>() -> TProperty?

src/Platform/Microsoft.Testing.Platform/PublicAPI/net/PublicAPI.Unshipped.txt

@@ -1 +1,2 @@
 #nullable enable
+Microsoft.Testing.Platform.Extensions.Messages.PropertyBag.FirstOrDefault<TProperty>() -> TProperty?