Add Path.AreEqual static extension method

PowerKit.Tests/Extensions/PathExtensionsTests.cs

@@ -29,6 +29,30 @@ public void GetInvalidPathChars_Test()
         Path.GetInvalidPathChars(false).Should().BeEquivalentTo(Path.GetInvalidPathChars());
     }
 
+    [Fact]
+    public void Normalize_Test()
+    {
+        // Act & assert
+        Path.Normalize("/foo/bar/").Should().Be(Path.GetFullPath("/foo/bar"));
+        Path.Normalize("/foo/./bar").Should().Be(Path.GetFullPath("/foo/bar"));
+        Path.Normalize("/foo/baz/../bar").Should().Be(Path.GetFullPath("/foo/bar"));
+        Path.Normalize("/foo/bar").Should().Be(Path.GetFullPath("/foo/bar"));
+    }
+
+    [Fact]
+    public void AreEqual_Test()
+    {
+        // Act & assert
+        Path.AreEqual(null, null).Should().BeTrue();
+        Path.AreEqual(null, "/foo").Should().BeFalse();
+        Path.AreEqual("/foo", null).Should().BeFalse();
+        Path.AreEqual("/foo/bar", "/foo/bar").Should().BeTrue();
+        Path.AreEqual("/foo/bar", "/foo/bar/").Should().BeTrue();
+        Path.AreEqual("/foo/./bar", "/foo/bar").Should().BeTrue();
+        Path.AreEqual("/foo/baz/../bar", "/foo/bar").Should().BeTrue();
+        Path.AreEqual("/foo/bar", "/foo/baz").Should().BeFalse();
+    }
+
     [Fact]
     public void EscapeFileName_Test()
     {

PowerKit/Extensions/PathExtensions.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -89,6 +90,33 @@ public static char[] GetInvalidFileNameChars(bool crossPlatform) =>
         public static char[] GetInvalidPathChars(bool crossPlatform) =>
             crossPlatform ? PathEx.CrossPlatformInvalidPathChars : Path.GetInvalidPathChars();
 
+        /// <summary>
+        /// Returns a normalized representation of the specified path by resolving
+        /// <c>.</c> and <c>..</c> segments and removing trailing directory separators.
+        /// </summary>
+        public static string Normalize(string path) =>
+            Path.TrimEndingDirectorySeparator(Path.GetFullPath(path));
+
+        /// <summary>
+        /// Compares two paths for equality, normalizing them first and using
+        /// the path comparison rules of the current operating system
+        /// (case-insensitive on Windows, case-sensitive on other platforms).
+        /// </summary>
+        public static bool AreEqual(string? path1, string? path2)
+        {
+            if (path1 is null && path2 is null)
+                return true;
+
+            if (path1 is null || path2 is null)
+                return false;
+
+            var comparison = OperatingSystem.IsWindows()
+                ? StringComparison.OrdinalIgnoreCase
+                : StringComparison.Ordinal;
+
+            return string.Equals(Path.Normalize(path1), Path.Normalize(path2), comparison);
+        }
+
         /// <summary>
         /// Replaces invalid file name characters with underscores and strips trailing dots and whitespace.
         /// When <paramref name="crossPlatform" /> is <see langword="true" />, considers characters