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).

tests/unit/presentation/components/Shared/Hooks/Dialog/ClientDialogFactory.spec.ts

@@ -0,0 +1,88 @@
+import { describe, it, expect } from 'vitest';
+import { determineDialogBasedOnEnvironment, WindowDialogCreationFunction, BrowserDialogCreationFunction } from '@/presentation/components/Shared/Hooks/Dialog/ClientDialogFactory';
+import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
+import { RuntimeEnvironmentStub } from '@tests/unit/shared/Stubs/RuntimeEnvironmentStub';
+import { DialogStub } from '@tests/unit/shared/Stubs/DialogStub';
+import { collectExceptionMessage } from '@tests/unit/shared/ExceptionCollector';
+
+describe('ClientDialogFactory', () => {
+  describe('determineDialogBasedOnEnvironment', () => {
+    describe('non-desktop environment', () => {
+      it('returns browser dialog', () => {
+        // arrange
+        const expectedDialog = new DialogStub();
+        const context = new DialogCreationTestSetup()
+          .withEnvironment(new RuntimeEnvironmentStub().withIsRunningAsDesktopApplication(false))
+          .withBrowserDialogFactory(() => expectedDialog);
+
+        // act
+        const actualDialog = context.createDialogForTest();
+
+        // assert
+        expect(expectedDialog).to.equal(actualDialog);
+      });
+    });
+    describe('desktop environment', () => {
+      it('returns window-injected dialog', () => {
+        // arrange
+        const expectedDialog = new DialogStub();
+        const context = new DialogCreationTestSetup()
+          .withEnvironment(new RuntimeEnvironmentStub().withIsRunningAsDesktopApplication(true))
+          .withWindowInjectedDialogFactory(() => expectedDialog);
+
+        // act
+        const actualDialog = context.createDialogForTest();
+
+        // assert
+        expect(expectedDialog).to.equal(actualDialog);
+      });
+      it('throws error when window-injected dialog is unavailable', () => {
+        // arrange
+        const expectedError = 'The Dialog API could not be retrieved from the window object.';
+        const context = new DialogCreationTestSetup()
+          .withEnvironment(new RuntimeEnvironmentStub().withIsRunningAsDesktopApplication(true))
+          .withWindowInjectedDialogFactory(() => undefined);
+
+        // act
+        const act = () => context.createDialogForTest();
+
+        // assert
+        const actualError = collectExceptionMessage(act);
+        expect(actualError).to.include(expectedError);
+      });
+    });
+  });
+});
+
+class DialogCreationTestSetup {
+  private environment: RuntimeEnvironment = new RuntimeEnvironmentStub();
+
+  private browserDialogFactory: BrowserDialogCreationFunction = () => new DialogStub();
+
+  private windowInjectedDialogFactory: WindowDialogCreationFunction = () => new DialogStub();
+
+  public withEnvironment(environment: RuntimeEnvironment): this {
+    this.environment = environment;
+    return this;
+  }
+
+  public withBrowserDialogFactory(browserDialogFactory: BrowserDialogCreationFunction): this {
+    this.browserDialogFactory = browserDialogFactory;
+    return this;
+  }
+
+  public withWindowInjectedDialogFactory(
+    windowInjectedDialogFactory: WindowDialogCreationFunction,
+  ): this {
+    this.windowInjectedDialogFactory = windowInjectedDialogFactory;
+    return this;
+  }
+
+  public createDialogForTest() {
+    return determineDialogBasedOnEnvironment(
+      this.environment,
+      this.windowInjectedDialogFactory,
+      this.browserDialogFactory,
+    );
+  }
+}