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/presentation/components/Shared/Hooks/Dialog/ClientDialogFactory.ts

@@ -0,0 +1,25 @@
+import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
+import { Dialog } from '@/presentation/common/Dialog';
+import { BrowserDialog } from '@/infrastructure/Dialog/Browser/BrowserDialog';
+
+export function determineDialogBasedOnEnvironment(
+  environment: RuntimeEnvironment,
+  windowInjectedDialogFactory: WindowDialogCreationFunction = () => globalThis.window.dialog,
+  browserDialogFactory: BrowserDialogCreationFunction = () => new BrowserDialog(),
+): Dialog {
+  if (!environment.isRunningAsDesktopApplication) {
+    return browserDialogFactory();
+  }
+  const dialog = windowInjectedDialogFactory();
+  if (!dialog) {
+    throw new Error([
+      'The Dialog API could not be retrieved from the window object.',
+      'This may indicate that the Dialog API is either not implemented or not correctly exposed in the current desktop environment.',
+    ].join('\n'));
+  }
+  return dialog;
+}
+
+export type WindowDialogCreationFunction = () => Dialog | undefined;
+
+export type BrowserDialogCreationFunction = () => Dialog;

src/presentation/components/Shared/Hooks/Dialog/UseDialog.ts

@@ -0,0 +1,14 @@
+import { Dialog } from '@/presentation/common/Dialog';
+import { CurrentEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironmentFactory';
+import { determineDialogBasedOnEnvironment } from './ClientDialogFactory';
+
+export function useDialog(
+  factory: DialogFactory = () => determineDialogBasedOnEnvironment(CurrentEnvironment),
+) {
+  const dialog = factory();
+  return {
+    dialog,
+  };
+}
+
+export type DialogFactory = () => Dialog;