chore: code cleanup

add storybook for save service

add parity to webassembly registrations

make simpler and more generic desktop extensions

Author: Tom Brewer

Mythetech.Components.Desktop/DesktopHost.cs

@@ -0,0 +1,6 @@
+namespace Mythetech.Components.Desktop;
+
+public enum DesktopHost
+{
+    Photino,
+}

Mythetech.Components.Desktop/DesktopRegistrationExtensions.cs

@@ -0,0 +1,27 @@
+using Microsoft.Extensions.DependencyInjection;
+using Mythetech.Components.Desktop.Photino;
+
+namespace Mythetech.Components.Desktop;
+
+/// <summary>
+/// Generic desktop service registration extensions
+/// </summary>
+public static class DesktopRegistrationExtensions
+{
+    /// <summary>
+    /// Adds required desktop services for a given host
+    /// </summary>
+    public static IServiceCollection AddDesktopServices(this IServiceCollection services, DesktopHost host = DesktopHost.Photino)
+    {
+        switch (host)
+        {
+            case DesktopHost.Photino:
+                services.AddPhotinoServices();
+                break;
+            default:
+                throw new ArgumentException("Invalid host type", nameof(host));
+        }
+
+        return services;
+    }
+}

Mythetech.Components.Desktop/Photino/PhotinoRegistrationExtensions.cs

@@ -20,6 +20,16 @@ public static IServiceCollection AddPhotinoServices(this IServiceCollection serv
 
         return services;
     }
+    
+    /// <summary>
+    /// Registers an instance of the running Photino App into the DI container for interop options
+    /// </summary>
+    public static PhotinoBlazorApp RegisterProvider(this PhotinoBlazorApp app)
+    {
+        var provider = app.Services;
+        
+        return RegisterProvider(app, provider);
+    }
 
     /// <summary>
     /// Registers an instance of the running Photino App into the DI container for interop options

Mythetech.Components.Storybook/Program.cs

@@ -22,13 +22,12 @@
 builder.Services.AddMudMarkdownServices();
 
 
-builder.Services.AddLinkOpeningService();
-builder.Services.AddFileOpenService();
+builder.Services.AddWebAssemblyServices();
 
 builder.Services.AddMessageBus();
 
 var host = builder.Build();
 
 host.Services.UseMessageBus();
-    
+
 await host.RunAsync();

Mythetech.Components.Storybook/Stories/FileServices.stories.razor

@@ -16,7 +16,7 @@
                 <MudDivider Class="my-2" />
 
                 <MudGrid>
-                    <MudItem xs="12" md="6">
+                    <MudItem xs="12" md="4">
                         <MudPaper Class="pa-4" Elevation="2">
                             <MudText Typo="Typo.h6" Class="mb-3">Open Files</MudText>
 
@@ -39,7 +39,7 @@
                         </MudPaper>
                     </MudItem>
 
-                    <MudItem xs="12" md="6">
+                    <MudItem xs="12" md="4">
                         <MudPaper Class="pa-4" Elevation="2">
                             <MudText Typo="Typo.h6" Class="mb-3">Open Folder</MudText>
 
@@ -51,6 +51,28 @@
                             </MudStack>
                         </MudPaper>
                     </MudItem>
+                    
+                    <MudItem xs="12" md="4">
+                        <MudPaper Class="pa-4" Elevation="2">
+                            <MudText Typo="Typo.h6" Class="mb-3">Save File</MudText>
+                            
+                            <MudStack Spacing="2">
+                                <MudTextField @bind-Value="_saveFileName" 
+                                              Label="File Name" 
+                                              Variant="Variant.Outlined" />
+                                              
+                                <MudTextField @bind-Value="_saveContent" 
+                                              Label="Content" 
+                                              Variant="Variant.Outlined"
+                                              Lines="3" />
+                                              
+                                <Button Text="Save File" 
+                                        Variant="Variant.Filled" 
+                                        Color="Color.Success"
+                                        OnClick="@SaveFile" />
+                            </MudStack>
+                        </MudPaper>
+                    </MudItem>
                 </MudGrid>
 
                 @if (_selectedPaths.Length > 0)
@@ -68,6 +90,13 @@
                     </MudPaper>
                 }
 
+                @if (!string.IsNullOrEmpty(_savedFileName))
+                {
+                    <MudAlert Severity="Severity.Success" Class="mt-4">
+                        File saved as: @_savedFileName
+                    </MudAlert>
+                }
+                
                 @if (!string.IsNullOrEmpty(_errorMessage))
                 {
                     <MudAlert Severity="Severity.Error" Class="mt-4" ShowCloseIcon="true" CloseIconClicked="@(() => _errorMessage = null)">
@@ -87,11 +116,17 @@
     [Inject]
     protected IFileOpenService FileOpenService { get; set; } = default!;
 
+    [Inject]
+    protected IFileSaveService FileSaveService { get; set; } = default!;
+    
     [Inject]
     protected ISnackbar Snackbar { get; set; } = default!;
 
     private string[] _selectedPaths = [];
     private string? _errorMessage;
+    private string? _savedFileName;
+    private string _saveFileName = "example.txt";
+    private string _saveContent = "Hello, World!";
 
     private async Task OpenSingleFile()
     {
@@ -155,10 +190,31 @@
         });
     }
 
+    private async Task SaveFile()
+    {
+        _savedFileName = null;
+        
+        await ExecuteWithErrorHandling(async () =>
+        {
+            var result = await FileSaveService.SaveFileAsync(_saveFileName, _saveContent);
+            
+            if (result)
+            {
+                _savedFileName = _saveFileName;
+                Snackbar.Add($"File saved successfully", Severity.Success);
+            }
+            else
+            {
+                Snackbar.Add("Save cancelled", Severity.Info);
+            }
+        });
+    }
+
     private async Task ExecuteWithErrorHandling(Func<Task> action)
     {
         _errorMessage = null;
         _selectedPaths = [];
+        _savedFileName = null;
 
         try
         {
@@ -181,7 +237,7 @@
     private string _explanationMarkdown = @"
 ## File Services
 
-The `IFileOpenService` provides a platform-agnostic way to open files and folders. It has different implementations for WebAssembly and Desktop (Photino).
+The `IFileOpenService` and `IFileSaveService` provide platform-agnostic ways to open and save files. They have different implementations for WebAssembly and Desktop (Photino).
 
 ### Opening Files
 
@@ -209,6 +265,16 @@ var files = await FileOpenService.OpenFileAsync(filters: filters);
 var folders = await FileOpenService.OpenFolderAsync(""Select a folder"");
 ```
 
+### Saving Files
+
+```csharp
+// Prompt and save
+var success = await FileSaveService.SaveFileAsync(""myfile.txt"", ""content"");
+
+// Just get the save location
+var path = await FileSaveService.PromptFileSaveAsync(""myfile"", ""txt"");
+```
+
 ### Error Handling
 
 In WebAssembly, the File System Access API may not be supported in all browsers. Wrap calls in a try-catch to handle `UnsupportedBrowserApiException`:
@@ -230,6 +296,7 @@ catch (UnsupportedBrowserApiException ex)
 **WebAssembly:**
 ```csharp
 builder.Services.AddFileOpenService();
+builder.Services.AddFileSaveService();
 // or register all WebAssembly services
 builder.Services.AddWebAssemblyServices();
 ```
@@ -240,4 +307,3 @@ builder.Services.AddPhotinoServices();
 ```
 ";
 }
-

Mythetech.Components.WebAssembly/FileSystemAccessFileOpenService.cs

@@ -131,4 +131,3 @@ private static string GetMimeTypeFromExtensions(string[] extensions)
         };
     }
 }
-

Mythetech.Components.WebAssembly/FileSystemAccessFileSaveService.cs

@@ -0,0 +1,101 @@
+using KristofferStrube.Blazor.FileSystemAccess;
+using Microsoft.JSInterop;
+using Mythetech.Components.Infrastructure;
+using Mythetech.Components.WebAssembly.Exceptions;
+
+namespace Mythetech.Components.WebAssembly;
+
+/// <summary>
+/// WebAssembly implementation of file save service using the File System Access API
+/// </summary>
+public class FileSystemAccessFileSaveService : IFileSaveService
+{
+    private readonly IFileSystemAccessService _fileSystemAccess;
+
+    /// <summary>
+    /// Creates a new instance of the file system access file save service
+    /// </summary>
+    /// <param name="fileSystemAccess">The file system access service</param>
+    public FileSystemAccessFileSaveService(IFileSystemAccessService fileSystemAccess)
+    {
+        _fileSystemAccess = fileSystemAccess;
+    }
+
+    /// <inheritdoc />
+    public async Task<bool> SaveFileAsync(string fileName, string data)
+    {
+        var location = await PromptFileSaveAsync(fileName);
+
+        if (string.IsNullOrWhiteSpace(location))
+            return false;
+
+        return true;
+    }
+
+    /// <inheritdoc />
+    public async Task<string?> PromptFileSaveAsync(string fileName, string extension = "txt")
+    {
+        try
+        {
+            var options = new SaveFilePickerOptionsStartInWellKnownDirectory
+            {
+                StartIn = WellKnownDirectory.Downloads,
+                SuggestedName = fileName,
+                Types =
+                [
+                    new FilePickerAcceptType
+                    {
+                        Description = $"{extension.ToUpperInvariant()} files",
+                        Accept = new Dictionary<string, string[]>
+                        {
+                            { GetMimeTypeFromExtension(extension), [$".{extension}"] }
+                        }
+                    }
+                ]
+            };
+
+            var fileHandle = await _fileSystemAccess.ShowSaveFilePickerAsync(options);
+
+            if (fileHandle is null)
+                return null;
+
+            return await fileHandle.GetNameAsync();
+        }
+        catch (JSException ex) when (IsUserCancellation(ex))
+        {
+            return null;
+        }
+        catch (JSException ex)
+        {
+            throw new UnsupportedBrowserApiException("File System Access", ex);
+        }
+    }
+
+    private static bool IsUserCancellation(JSException ex)
+    {
+        return ex.Message.Contains("AbortError") || ex.Message.Contains("The user aborted a request");
+    }
+
+    private static string GetMimeTypeFromExtension(string extension)
+    {
+        var ext = extension.ToLowerInvariant();
+        return ext switch
+        {
+            "txt" => "text/plain",
+            "json" => "application/json",
+            "xml" => "application/xml",
+            "html" or "htm" => "text/html",
+            "css" => "text/css",
+            "js" => "application/javascript",
+            "png" => "image/png",
+            "jpg" or "jpeg" => "image/jpeg",
+            "gif" => "image/gif",
+            "svg" => "image/svg+xml",
+            "pdf" => "application/pdf",
+            "zip" => "application/zip",
+            "csv" => "text/csv",
+            _ => "application/octet-stream"
+        };
+    }
+}
+

Mythetech.Components.WebAssembly/JavaScriptLinkOpenService.cs

@@ -26,42 +26,4 @@ public async Task OpenLinkAsync(string url)
     {
         await _jsRuntime.InvokeVoidAsync("open", url, "_blank");      
     }
-}
-
-/// <summary>
-/// WebAssembly service registration extensions
-/// </summary>
-public static class WebAssemblyServiceExtensions
-{
-    /// <summary>
-    /// Registers the link opening service for WebAssembly
-    /// </summary>
-    public static IServiceCollection AddLinkOpeningService(this IServiceCollection services)
-    {
-        services.AddTransient<ILinkOpenService, JavaScriptLinkOpenService>();
-        
-        return services;
-    }
-
-    /// <summary>
-    /// Registers the file open service for WebAssembly using the File System Access API
-    /// </summary>
-    public static IServiceCollection AddFileOpenService(this IServiceCollection services)
-    {
-        services.AddFileSystemAccessServiceInProcess();
-        services.AddTransient<IFileOpenService, FileSystemAccessFileOpenService>();
-
-        return services;
-    }
-
-    /// <summary>
-    /// Registers all WebAssembly-specific services
-    /// </summary>
-    public static IServiceCollection AddWebAssemblyServices(this IServiceCollection services)
-    {
-        services.AddLinkOpeningService();
-        services.AddFileOpenService();
-
-        return services;
-    }
 }