Merge branch 'main' into winui

# Conflicts:
#	CommunityToolkit.WinUI.UI.Animations/Expressions/ExpressionNodes/ExpressionNode.cs
#	CommunityToolkit.WinUI.UI.Animations/Extensions/System/GuidExtensions.cs
#	CommunityToolkit.WinUI.UI.Media/Extensions/System/GuidExtensions.cs
#	CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Effects.Internals.cs
#	CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Effects.cs
#	CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Initialization.cs
#	CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Merge.cs
#	CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.cs

Author: azchohfi

CommunityToolkit.WinUI.UI.Animations/Expressions/ExpressionNodes/ExpressionNode.cs

@@ -282,14 +282,10 @@ internal void EnsureReferenceInfo()
                 }
 
                 // Create a map to store the generated paramNames for each CompObj
-                uint id = 0;
                 _compObjToParamNameMap = new Dictionary<CompositionObject, string>();
                 foreach (var compObj in compObjects)
                 {
-                    // compObj.ToString() will return something like "Microsoft.UI.Composition.SpriteVisual"
-                    // Make it look like "SpriteVisual_1"
-                    string paramName = compObj.ToString();
-                    paramName = $"{paramName.Substring(paramName.LastIndexOf('.') + 1)}_{++id}";       // make sure the created param name doesn't overwrite a custom name
+                    string paramName = Guid.NewGuid().ToUppercaseAsciiLetters();
 
                     _compObjToParamNameMap.Add(compObj, paramName);
                 }

CommunityToolkit.WinUI.UI.Animations/Extensions/System/GuidExtensions.cs

@@ -0,0 +1,36 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System;
+using System.Diagnostics.Contracts;
+
+namespace CommunityToolkit.WinUI.UI.Animations
+{
+    /// <summary>
+    /// An extension <see langword="class"/> for the <see cref="Guid"/> type
+    /// </summary>
+    internal static class GuidExtensions
+    {
+        /// <summary>
+        /// Returns a <see cref="string"/> representation of a <see cref="Guid"/> only made of uppercase letters
+        /// </summary>
+        /// <param name="guid">The input <see cref="Guid"/> to process</param>
+        /// <returns>A <see cref="string"/> representation of <paramref name="guid"/> only made up of letters in the [A-Z] range</returns>
+        [Pure]
+        public static string ToUppercaseAsciiLetters(in this Guid guid)
+        {
+            // Composition IDs must only be composed of characters in the [A-Z0-9_] set,
+            // and also have the restriction that the initial character cannot be a digit.
+            // Because of this, we need to prepend an underscore to a serialized guid to
+            // avoid cases where the first character is a digit. Additionally, we're forced
+            // to use ToUpper() here because ToString("N") currently returns a lowercase
+            // hexadecimal string. Note: this extension might be improved once we move to
+            // .NET 5 in the WinUI 3 release, by using string.Create<TState>(...) to only
+            // have a single string allocation, and then using Guid.TryFormat(...) to
+            // serialize the guid in place over the Span<char> starting from the second
+            // character. For now, this implementation is fine on UWP and still fast enough.
+            return $"_{guid.ToString("N").ToUpper()}";
+        }
+    }
+}

CommunityToolkit.WinUI.UI.Media/Extensions/System/GuidExtensions.cs

@@ -5,6 +5,7 @@
 using System;
 using System.Diagnostics.Contracts;
 using System.Threading.Tasks;
+using CommunityToolkit.WinUI.UI.Animations;
 using Microsoft.Graphics.Canvas.Effects;
 using Microsoft.UI.Composition;
 using Windows.Graphics.Effects;

CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Effects.Internals.cs

@@ -7,6 +7,7 @@
 using System.Diagnostics.Contracts;
 using System.Linq;
 using System.Threading.Tasks;
+using CommunityToolkit.WinUI.UI.Animations;
 using Microsoft.Graphics.Canvas.Effects;
 using Microsoft.UI.Composition;
 using Windows.Graphics.Effects;

CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Effects.cs

@@ -7,6 +7,7 @@
 using System.Diagnostics.Contracts;
 using System.Numerics;
 using System.Threading.Tasks;
+using CommunityToolkit.WinUI.UI.Animations;
 using CommunityToolkit.WinUI.UI.Media.Helpers;
 using CommunityToolkit.WinUI.UI.Media.Helpers.Cache;
 using Microsoft.Graphics.Canvas;

CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Initialization.cs

@@ -7,6 +7,7 @@
 using System.Diagnostics.Contracts;
 using System.Linq;
 using System.Threading.Tasks;
+using CommunityToolkit.WinUI.UI.Animations;
 using Microsoft.Graphics.Canvas.Effects;
 using Microsoft.UI.Composition;
 using Windows.Graphics.Effects;

CommunityToolkit.WinUI.UI.Media/Pipelines/PipelineBuilder.Merge.cs

@@ -6,6 +6,7 @@
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
 using System.Threading.Tasks;
+using CommunityToolkit.WinUI.UI.Animations;
 using Microsoft.UI.Composition;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Hosting;