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/WindowVariables/WindowVariablesValidator.ts

@@ -18,13 +18,14 @@ export function validateWindowVariables(variables: Partial<WindowVariables>) {
 }
 
 function* testEveryProperty(variables: Partial<WindowVariables>): Iterable<string> {
-  const tests: {
-    [K in PropertyKeys<Required<WindowVariables>>]: boolean;
-  } = {
+  const tests: Record<PropertyKeys<Required<WindowVariables>>, boolean> = {
     os: testOperatingSystem(variables.os),
-    isDesktop: testIsDesktop(variables.isDesktop),
+    isRunningAsDesktopApplication: testIsRunningAsDesktopApplication(
+      variables.isRunningAsDesktopApplication,
+    ),
     codeRunner: testCodeRunner(variables),
     log: testLogger(variables),
+    dialog: testDialog(variables),
   };
 
   for (const [propertyName, testResult] of Object.entries(tests)) {
@@ -48,23 +49,30 @@ function testOperatingSystem(os: unknown): boolean {
 }
 
 function testLogger(variables: Partial<WindowVariables>): boolean {
-  if (!variables.isDesktop) {
+  if (!variables.isRunningAsDesktopApplication) {
     return true;
   }
   return isPlainObject(variables.log);
 }
 
 function testCodeRunner(variables: Partial<WindowVariables>): boolean {
-  if (!variables.isDesktop) {
+  if (!variables.isRunningAsDesktopApplication) {
     return true;
   }
   return isPlainObject(variables.codeRunner)
     && isFunction(variables.codeRunner.runCode);
 }
 
-function testIsDesktop(isDesktop: unknown): boolean {
-  if (isDesktop === undefined) {
+function testIsRunningAsDesktopApplication(isRunningAsDesktopApplication: unknown): boolean {
+  if (isRunningAsDesktopApplication === undefined) {
     return true;
   }
-  return isBoolean(isDesktop);
+  return isBoolean(isRunningAsDesktopApplication);
+}
+
+function testDialog(variables: Partial<WindowVariables>): boolean {
+  if (!variables.isRunningAsDesktopApplication) {
+    return true;
+  }
+  return isPlainObject(variables.dialog);
 }