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/infrastructure/RuntimeEnvironment/Browser/BrowserRuntimeEnvironment.spec.ts

@@ -1,4 +1,3 @@
-// eslint-disable-next-line max-classes-per-file
 import { describe, it, expect } from 'vitest';
 import { BrowserOsDetector } from '@/infrastructure/RuntimeEnvironment/Browser/BrowserOs/BrowserOsDetector';
 import { OperatingSystem } from '@/domain/OperatingSystem';
@@ -42,31 +41,32 @@ describe('BrowserRuntimeEnvironment', () => {
       expect(actualTouchSupport).to.equal(expectedTouchSupport);
     });
   });
-  describe('isDesktop', () => {
-    it('returns true when window property isDesktop is true', () => {
+  describe('isRunningAsDesktopApplication', () => {
+    it('returns true when window property `isRunningAsDesktopApplication` is true', () => {
       // arrange
-      const desktopWindow = {
-        isDesktop: true,
+      const expectedValue = true;
+      const desktopWindow: Partial<Window> = {
+        isRunningAsDesktopApplication: true,
       };
       // act
       const sut = new BrowserRuntimeEnvironmentBuilder()
         .withWindow(desktopWindow)
         .build();
       // assert
-      expect(sut.isDesktop).to.equal(true);
+      expect(sut.isRunningAsDesktopApplication).to.equal(expectedValue);
     });
-    it('returns false when window property isDesktop is false', () => {
+    it('returns false when window property `isRunningAsDesktopApplication` is undefined', () => {
       // arrange
       const expectedValue = false;
-      const browserWindow = {
-        isDesktop: false,
+      const browserWindow: Partial<Window> = {
+        isRunningAsDesktopApplication: undefined,
       };
       // act
       const sut = new BrowserRuntimeEnvironmentBuilder()
         .withWindow(browserWindow)
         .build();
       // assert
-      expect(sut.isDesktop).to.equal(expectedValue);
+      expect(sut.isRunningAsDesktopApplication).to.equal(expectedValue);
     });
   });
   describe('os', () => {
@@ -112,47 +112,6 @@ describe('BrowserRuntimeEnvironment', () => {
       // assert
       expect(actual).to.equal(expected);
     });
-    describe('desktop os', () => {
-      describe('returns from window property `os`', () => {
-        const testValues = [
-          OperatingSystem.macOS,
-          OperatingSystem.Windows,
-          OperatingSystem.Linux,
-        ];
-        testValues.forEach((testValue) => {
-          it(`given ${OperatingSystem[testValue]}`, () => {
-            // arrange
-            const expectedOs = testValue;
-            const desktopWindowWithOs = {
-              isDesktop: true,
-              os: expectedOs,
-            };
-            // act
-            const sut = new BrowserRuntimeEnvironmentBuilder()
-              .withWindow(desktopWindowWithOs)
-              .build();
-            // assert
-            const actualOs = sut.os;
-            expect(actualOs).to.equal(expectedOs);
-          });
-        });
-      });
-      describe('returns undefined when window property `os` is absent', () => {
-        itEachAbsentObjectValue((absentValue) => {
-          // arrange
-          const expectedValue = undefined;
-          const windowWithAbsentOs = {
-            os: absentValue as never,
-          };
-          // act
-          const sut = new BrowserRuntimeEnvironmentBuilder()
-            .withWindow(windowWithAbsentOs)
-            .build();
-          // assert
-          expect(sut.os).to.equal(expectedValue);
-        });
-      });
-    });
   });
   describe('isNonProduction', () => {
     [true, false].forEach((value) => {