Full cleanup pass

Author: JimBobSquarePants

src/ImageSharp.Drawing.WebGPU/RemoteExecutor/RemoteExecutor.cs

@@ -10,7 +10,7 @@ namespace SixLabors.ImageSharp.Drawing.Processing.Backends;
 /// <summary>
 /// Minimal remote executor that invokes a named method in a child process.
 /// The child process entry point (<see cref="Program.Main"/>) dispatches to
-/// the requested method by name — no reflection is used.
+/// the requested method by name; no reflection is used.
 /// Adapted from Microsoft.DotNet.RemoteExecutor (MIT license).
 /// </summary>
 internal static class RemoteExecutor
@@ -49,7 +49,7 @@ static RemoteExecutor()
             // Walk up from the runtime directory to find the dotnet host executable.
             // The runtime directory is typically:
             //   <dotnet_root>/shared/Microsoft.NETCore.App/<version>/
-            // so dotnet.exe is 3–4 levels up depending on trailing separator.
+            // so dotnet.exe is 3-4 levels up depending on trailing separator.
             string? directory = RuntimeEnvironment.GetRuntimeDirectory();
             for (int i = 0; i < 4 && directory is not null; i++)
             {

src/ImageSharp.Drawing.WebGPU/WebGPUDeviceContext{TPixel}.cs

@@ -38,7 +38,10 @@ public WebGPUDeviceContext(Configuration configuration)
 
         try
         {
-            if (!WebGPURuntime.TryGetOrCreateDevice(out WebGPUDeviceHandle? deviceHandle, out WebGPUQueueHandle? queueHandle, out WebGPUEnvironmentError errorCode)
+            if (!WebGPURuntime.TryGetOrCreateDevice(
+                    out WebGPUDeviceHandle? deviceHandle,
+                    out WebGPUQueueHandle? queueHandle,
+                    out WebGPUEnvironmentError errorCode)
                 || deviceHandle is null
                 || queueHandle is null)
             {
@@ -121,10 +124,9 @@ internal WebGPUDeviceContext(Configuration configuration, WebGPUDeviceHandle dev
 
     /// <summary>
     /// Gets the WebGPU drawing backend owned by this context.
-    /// Use this to inspect per-flush diagnostics
-    /// (<see cref="WebGPUDrawingBackend.DiagnosticLastFlushUsedGPU"/>,
-    /// <see cref="WebGPUDrawingBackend.DiagnosticLastSceneFailure"/>) when you need to confirm whether the staged
-    /// GPU path executed or fell back to the CPU backend.
+    /// Use this to inspect per-flush diagnostics such as
+    /// <see cref="WebGPUDrawingBackend.DiagnosticLastFlushUsedGPU"/> and
+    /// <see cref="WebGPUDrawingBackend.DiagnosticLastSceneFailure"/>.
     /// </summary>
     public WebGPUDrawingBackend Backend { get; }
 
@@ -154,15 +156,15 @@ public WebGPURenderTarget<TPixel> CreateRenderTarget(int width, int height)
     }
 
     /// <summary>
-    /// Creates a native-only frame over an externally-owned WebGPU texture and view — typically the per-frame
+    /// Creates a frame over an externally-owned WebGPU texture and view, typically the per-frame
     /// swap-chain back buffer obtained from <c>wgpuSurfaceGetCurrentTexture</c> on a host-owned surface.
     /// </summary>
     /// <param name="textureHandle">The external WebGPU texture handle.</param>
     /// <param name="textureViewHandle">The external WebGPU texture-view handle.</param>
     /// <param name="format">The texture format identifier. Must match the format expected for <typeparamref name="TPixel"/>.</param>
     /// <param name="width">The frame width in pixels.</param>
     /// <param name="height">The frame height in pixels.</param>
-    /// <returns>A native-only canvas frame.</returns>
+    /// <returns>A canvas frame backed by the external WebGPU texture.</returns>
     /// <remarks>
     /// The caller retains ownership of the texture and view; this context does not release them.
     /// The texture must have been created with <c>RenderAttachment | TextureBinding</c> usage.
@@ -178,7 +180,7 @@ public NativeCanvasFrame<TPixel> CreateFrame(
         => this.CreateFrame(CreateExternalTextureHandle(textureHandle), CreateExternalTextureViewHandle(textureViewHandle), format, width, height);
 
     /// <summary>
-    /// Creates a drawing canvas that renders directly into an externally-owned WebGPU texture — typically the per-frame
+    /// Creates a drawing canvas that renders directly into an externally-owned WebGPU texture, typically the per-frame
     /// swap-chain back buffer obtained from <c>wgpuSurfaceGetCurrentTexture</c> on a host-owned surface.
     /// </summary>
     /// <param name="textureHandle">The external WebGPU texture handle.</param>
@@ -198,10 +200,16 @@ public DrawingCanvas<TPixel> CreateCanvas(
         WebGPUTextureFormatId format,
         int width,
         int height)
-        => this.CreateCanvas(CreateExternalTextureHandle(textureHandle), CreateExternalTextureViewHandle(textureViewHandle), format, width, height, new DrawingOptions());
+        => this.CreateCanvas(
+            CreateExternalTextureHandle(textureHandle),
+            CreateExternalTextureViewHandle(textureViewHandle),
+            format,
+            width,
+            height,
+            new DrawingOptions());
 
     /// <summary>
-    /// Creates a drawing canvas that renders directly into an externally-owned WebGPU texture — typically the per-frame
+    /// Creates a drawing canvas that renders directly into an externally-owned WebGPU texture, typically the per-frame
     /// swap-chain back buffer obtained from <c>wgpuSurfaceGetCurrentTexture</c> on a host-owned surface.
     /// </summary>
     /// <param name="textureHandle">The external WebGPU texture handle.</param>
@@ -246,14 +254,14 @@ internal void ThrowIfDisposed()
         => ObjectDisposedException.ThrowIf(this.isDisposed, this);
 
     /// <summary>
-    /// Creates a native-only frame over wrapped texture handles that are already in this assembly's ownership model.
+    /// Creates a frame over wrapped texture handles that are already in this assembly's ownership model.
     /// </summary>
     /// <param name="textureHandle">The wrapped texture handle.</param>
     /// <param name="textureViewHandle">The wrapped texture-view handle.</param>
     /// <param name="format">The texture format identifier.</param>
     /// <param name="width">The frame width in pixels.</param>
     /// <param name="height">The frame height in pixels.</param>
-    /// <returns>A native-only frame over the supplied handles.</returns>
+    /// <returns>A frame backed by the supplied handles.</returns>
     internal NativeCanvasFrame<TPixel> CreateFrame(
         WebGPUTextureHandle textureHandle,
         WebGPUTextureViewHandle textureViewHandle,