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/presentation/bootstrapping/ClientLoggerFactory.ts

@@ -1,5 +1,5 @@
+import { HostRuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/HostRuntimeEnvironment';
 import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
-import { IRuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/IRuntimeEnvironment';
 import { ConsoleLogger } from '@/infrastructure/Log/ConsoleLogger';
 import { Logger } from '@/application/Common/Log/Logger';
 import { LoggerFactory } from '@/application/Common/Log/LoggerFactory';
@@ -11,7 +11,9 @@ export class ClientLoggerFactory implements LoggerFactory {
 
   public readonly logger: Logger;
 
-  protected constructor(environment: IRuntimeEnvironment = RuntimeEnvironment.CurrentEnvironment) {
+  protected constructor(
+    environment: RuntimeEnvironment = HostRuntimeEnvironment.CurrentEnvironment,
+  ) {
     if (environment.isDesktop) {
       this.logger = new WindowInjectedLogger();
       return;

src/presentation/bootstrapping/DependencyProvider.ts

@@ -5,7 +5,6 @@ import { useAutoUnsubscribedEvents } from '@/presentation/components/Shared/Hook
 import { useClipboard } from '@/presentation/components/Shared/Hooks/Clipboard/UseClipboard';
 import { useCurrentCode } from '@/presentation/components/Shared/Hooks/UseCurrentCode';
 import { IApplicationContext } from '@/application/Context/IApplicationContext';
-import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
 import {
   AnyLifetimeInjectionKey, InjectionKeySelector, InjectionKeys, SingletonKey,
   TransientKey, injectKey,
@@ -14,6 +13,7 @@ import { PropertyKeys } from '@/TypeHelpers';
 import { useUserSelectionState } from '@/presentation/components/Shared/Hooks/UseUserSelectionState';
 import { useLogger } from '@/presentation/components/Shared/Hooks/UseLogger';
 import { useCodeRunner } from '@/presentation/components/Shared/Hooks/UseCodeRunner';
+import { HostRuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/HostRuntimeEnvironment';
 
 export function provideDependencies(
   context: IApplicationContext,
@@ -33,7 +33,7 @@ export function provideDependencies(
     ),
     useRuntimeEnvironment: (di) => di.provide(
       InjectionKeys.useRuntimeEnvironment,
-      RuntimeEnvironment.CurrentEnvironment,
+      HostRuntimeEnvironment.CurrentEnvironment,
     ),
     useAutoUnsubscribedEvents: (di) => di.provide(
       InjectionKeys.useAutoUnsubscribedEvents,

src/presentation/bootstrapping/Modules/MobileSafariActivePseudoClassEnabler.ts

@@ -1,11 +1,11 @@
-import { IRuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/IRuntimeEnvironment';
-import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
+import { HostRuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/HostRuntimeEnvironment';
 import { OperatingSystem } from '@/domain/OperatingSystem';
+import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
 import { Bootstrapper } from '../Bootstrapper';
 
 export class MobileSafariActivePseudoClassEnabler implements Bootstrapper {
   constructor(
-    private readonly currentEnvironment = RuntimeEnvironment.CurrentEnvironment,
+    private readonly currentEnvironment = HostRuntimeEnvironment.CurrentEnvironment,
     private readonly browser: BrowserAccessor = GlobalBrowserAccessor,
   ) {
 
@@ -42,14 +42,14 @@ export interface BrowserAccessor {
   addWindowEventListener(...args: Parameters<typeof window.addEventListener>): void;
 }
 
-function isMobileSafari(environment: IRuntimeEnvironment, userAgent: string): boolean {
+function isMobileSafari(environment: RuntimeEnvironment, userAgent: string): boolean {
   if (!isMobileAppleOperatingSystem(environment)) {
     return false;
   }
   return isSafari(userAgent);
 }
 
-function isMobileAppleOperatingSystem(environment: IRuntimeEnvironment): boolean {
+function isMobileAppleOperatingSystem(environment: RuntimeEnvironment): boolean {
   if (environment.os === undefined) {
     return false;
   }

src/presentation/components/Code/CodeButtons/CodeRunButton.vue

@@ -26,11 +26,9 @@ export default defineComponent({
 
     async function executeCode() {
       if (!codeRunner) { throw new Error('missing code runner'); }
-      if (os === undefined) { throw new Error('unidentified host operating system'); }
       await codeRunner.runCode(
         currentContext.state.code.current,
         currentContext.app.info.name,
-        os,
       );
     }
 

src/presentation/components/Shared/Hooks/UseRuntimeEnvironment.ts

@@ -1,5 +1,5 @@
-import { IRuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/IRuntimeEnvironment';
+import { RuntimeEnvironment } from '@/infrastructure/RuntimeEnvironment/RuntimeEnvironment';
 
-export function useRuntimeEnvironment(environment: IRuntimeEnvironment) {
+export function useRuntimeEnvironment(environment: RuntimeEnvironment) {
   return environment;
 }