Fix handling special chars in script paths

This commit improves the handling of paths with spaces or special
characters during script execution in the desktop application.

Key improvements:

- Paths are now quoted for macOS/Linux, addressing issues with
  whitespace or single quotes.
- Windows paths are enclosed in double quotes to handle special
  characters.

Other supporting changes:

- Add more documentation for terminal execution commands.
- Refactor terminal script file execution into a dedicated file for
  improved separation of concerns.
- Refactor naming of `RuntimeEnvironment` to align with naming
  conventions (no interface with I prefix) and for clarity.
- Refactor `TemporaryFileCodeRunner` to simplify it by removing the `os`
  parameter and handling OS-specific logic within the filename generator
  instead.
- Refactor `fileName` to `filename` for consistency.

src/infrastructure/RuntimeEnvironment/RuntimeEnvironment.ts

@@ -1,50 +1,7 @@
 import { OperatingSystem } from '@/domain/OperatingSystem';
-import { WindowVariables } from '@/infrastructure/WindowVariables/WindowVariables';
-import { IEnvironmentVariables } from '@/infrastructure/EnvironmentVariables/IEnvironmentVariables';
-import { EnvironmentVariablesFactory } from '@/infrastructure/EnvironmentVariables/EnvironmentVariablesFactory';
-import { ConditionBasedOsDetector } from './BrowserOs/ConditionBasedOsDetector';
-import { BrowserEnvironment, BrowserOsDetector } from './BrowserOs/BrowserOsDetector';
-import { IRuntimeEnvironment } from './IRuntimeEnvironment';
-import { isTouchEnabledDevice } from './TouchSupportDetection';
 
-export class RuntimeEnvironment implements IRuntimeEnvironment {
-  public static readonly CurrentEnvironment: IRuntimeEnvironment = new RuntimeEnvironment(window);
-
-  public readonly isDesktop: boolean;
-
-  public readonly os: OperatingSystem | undefined;
-
-  public readonly isNonProduction: boolean;
-
-  protected constructor(
-    window: Partial<Window>,
-    environmentVariables: IEnvironmentVariables = EnvironmentVariablesFactory.Current.instance,
-    browserOsDetector: BrowserOsDetector = new ConditionBasedOsDetector(),
-    touchDetector = isTouchEnabledDevice,
-  ) {
-    if (!window) { throw new Error('missing window'); } // do not trust strictNullChecks for global objects
-    this.isNonProduction = environmentVariables.isNonProduction;
-    this.isDesktop = isDesktop(window);
-    if (this.isDesktop) {
-      this.os = window?.os;
-    } else {
-      this.os = undefined;
-      const userAgent = getUserAgent(window);
-      if (userAgent) {
-        const browserEnvironment: BrowserEnvironment = {
-          userAgent,
-          isTouchSupported: touchDetector(),
-        };
-        this.os = browserOsDetector.detect(browserEnvironment);
-      }
-    }
-  }
-}
-
-function getUserAgent(window: Partial<Window>): string | undefined {
-  return window?.navigator?.userAgent;
-}
-
-function isDesktop(window: Partial<WindowVariables>): boolean {
-  return window?.isDesktop === true;
+export interface RuntimeEnvironment {
+  readonly isDesktop: boolean;
+  readonly os: OperatingSystem | undefined;
+  readonly isNonProduction: boolean;
 }