Show native save dialogs in desktop app #50, #264

This commit introduces native operating system file dialogs in the
desktop application replacing the existing web-based dialogs.

It lays the foundation for future enhancements such as:

- Providing error messages when saving or executing files, addressing
  #264.
- Creating system restore points, addressing #50.

Documentation updates:

- Update `desktop-vs-web-features.md` with added functionality.
- Update `README.md` with security feature highlights.
- Update home page documentation to emphasize security features.

Other supporting changes include:

- Integrate IPC communication channels for secure Electron dialog API
  interactions.
- Refactor `IpcRegistration` for more type-safety and simplicity.
- Introduce a Vue hook to encapsulate dialog functionality.
- Improve errors during IPC registration for easier troubleshooting.
- Move `ClientLoggerFactory` for consistency in hooks organization and
  remove `LoggerFactory` interface for simplicity.
- Add tests for the save file dialog in the browser context.
- Add `Blob` polyfill in tests to compensate for the missing
  `blob.text()` function in `jsdom` (see jsdom/jsdom#2555).

Improve environment detection logic:

- Treat test environment as browser environments to correctly activate
  features based on the environment. This resolves issues where the
  environment is misidentified as desktop, but Electron preloader APIs
  are missing.
- Rename `isDesktop` environment identification variable to
  `isRunningAsDesktopApplication` for better clarity and to avoid
  confusion with desktop environments in web/browser/test environments.
- Simplify `BrowserRuntimeEnvironment` to consistently detect
  non-desktop application environments.
- Improve environment detection for Electron main process
  (electron/electron#2288).

src/infrastructure/Dialog/Browser/FileSaverDialog.ts

@@ -0,0 +1,39 @@
+import fileSaver from 'file-saver';
+import { FileType } from '@/presentation/common/Dialog';
+import { BrowserSaveFileDialog } from './BrowserSaveFileDialog';
+
+export type SaveAsFunction = (data: Blob, filename?: string) => void;
+
+export type WindowOpenFunction = (url: string, target: string, features: string) => void;
+
+export class FileSaverDialog implements BrowserSaveFileDialog {
+  constructor(
+    private readonly fileSaverSaveAs: SaveAsFunction = fileSaver.saveAs,
+    private readonly windowOpen: WindowOpenFunction = window.open.bind(window),
+  ) { }
+
+  public saveFile(
+    fileContents: string,
+    fileName: string,
+    fileType: FileType,
+  ): void {
+    const mimeType = MimeTypes[fileType];
+    this.saveBlob(fileContents, mimeType, fileName);
+  }
+
+  private saveBlob(file: BlobPart, mimeType: string, fileName: string): void {
+    try {
+      const blob = new Blob([file], { type: mimeType });
+      this.fileSaverSaveAs(blob, fileName);
+    } catch (e) {
+      this.windowOpen(`data:${mimeType},${encodeURIComponent(file.toString())}`, '_blank', '');
+    }
+  }
+}
+
+const MimeTypes: Record<FileType, string> = {
+  // Some browsers (including firefox + IE) require right mime type
+  // otherwise they ignore extension and save the file as text.
+  [FileType.BatchFile]: 'application/bat', // https://en.wikipedia.org/wiki/Batch_file
+  [FileType.ShellScript]: 'text/x-shellscript', // https://de.wikipedia.org/wiki/Shellskript#MIME-Typ
+} as const;