Improve desktop runtime execution tests

Test improvements:

- Capture titles for all macOS windows, not just the frontmost.
- Incorporate missing application log files.
- Improve log clarity with enriched context.
- Improve application termination on macOS by reducing grace period.
- Ensure complete application termination on macOS.
- Validate Vue application loading through an initial log.
- Support ignoring environment-specific `stderr` errors.
- Do not fail the test if working directory cannot be deleted.
- Use retry pattern when installing dependencies due to network errors.

Refactorings:

- Migrate the test code to TypeScript.
- Replace deprecated `rmdir` with `rm` for error-resistant directory
  removal.
- Improve sanity checking by shifting from App.vue to Vue bootstrapper.
- Centralize environment variable management with `EnvironmentVariables`
  construct.
- Rename infrastructure/Environment to RuntimeEnvironment for clarity.
- Isolate WindowVariables and SystemOperations from RuntimeEnvironment.
- Inject logging via preloader.
- Correct mislabeled RuntimeSanity tests.

Configuration:

- Introduce `npm run check:desktop` for simplified execution.
- Omit `console.log` override due to `nodeIntegration` restrictions and
  reveal logging functionality using context-bridging.

src/infrastructure/RuntimeEnvironment/BrowserOs/BrowserOsDetector.ts

@@ -0,0 +1,57 @@
+import { OperatingSystem } from '@/domain/OperatingSystem';
+import { DetectorBuilder } from './DetectorBuilder';
+import { IBrowserOsDetector } from './IBrowserOsDetector';
+
+export class BrowserOsDetector implements IBrowserOsDetector {
+  private readonly detectors = BrowserDetectors;
+
+  public detect(userAgent: string): OperatingSystem | undefined {
+    if (!userAgent) {
+      return undefined;
+    }
+    for (const detector of this.detectors) {
+      const os = detector.detect(userAgent);
+      if (os !== undefined) {
+        return os;
+      }
+    }
+    return undefined;
+  }
+}
+
+// Reference: https://github.com/keithws/browser-report/blob/master/index.js#L304
+const BrowserDetectors = [
+  define(OperatingSystem.KaiOS, (b) => b
+    .mustInclude('KAIOS')),
+  define(OperatingSystem.ChromeOS, (b) => b
+    .mustInclude('CrOS')),
+  define(OperatingSystem.BlackBerryOS, (b) => b
+    .mustInclude('BlackBerry')),
+  define(OperatingSystem.BlackBerryTabletOS, (b) => b
+    .mustInclude('RIM Tablet OS')),
+  define(OperatingSystem.BlackBerry, (b) => b
+    .mustInclude('BB10')),
+  define(OperatingSystem.Android, (b) => b
+    .mustInclude('Android').mustNotInclude('Windows Phone')),
+  define(OperatingSystem.Android, (b) => b
+    .mustInclude('Adr').mustNotInclude('Windows Phone')),
+  define(OperatingSystem.iOS, (b) => b
+    .mustInclude('like Mac OS X')),
+  define(OperatingSystem.Linux, (b) => b
+    .mustInclude('Linux').mustNotInclude('Android').mustNotInclude('Adr')),
+  define(OperatingSystem.Windows, (b) => b
+    .mustInclude('Windows').mustNotInclude('Windows Phone')),
+  define(OperatingSystem.WindowsPhone, (b) => b
+    .mustInclude('Windows Phone')),
+  define(OperatingSystem.macOS, (b) => b
+    .mustInclude('OS X').mustNotInclude('Android').mustNotInclude('like Mac OS X')),
+];
+
+function define(
+  os: OperatingSystem,
+  applyRules: (builder: DetectorBuilder) => DetectorBuilder,
+): IBrowserOsDetector {
+  const builder = new DetectorBuilder(os);
+  applyRules(builder);
+  return builder.build();
+}

src/infrastructure/RuntimeEnvironment/BrowserOs/DetectorBuilder.ts

@@ -0,0 +1,54 @@
+import { OperatingSystem } from '@/domain/OperatingSystem';
+import { IBrowserOsDetector } from './IBrowserOsDetector';
+
+export class DetectorBuilder {
+  private readonly existingPartsInUserAgent = new Array<string>();
+
+  private readonly notExistingPartsInUserAgent = new Array<string>();
+
+  constructor(private readonly os: OperatingSystem) { }
+
+  public mustInclude(str: string): DetectorBuilder {
+    return this.add(str, this.existingPartsInUserAgent);
+  }
+
+  public mustNotInclude(str: string): DetectorBuilder {
+    return this.add(str, this.notExistingPartsInUserAgent);
+  }
+
+  public build(): IBrowserOsDetector {
+    if (!this.existingPartsInUserAgent.length) {
+      throw new Error('Must include at least a part');
+    }
+    return {
+      detect: (agent) => this.detect(agent),
+    };
+  }
+
+  private detect(userAgent: string): OperatingSystem {
+    if (!userAgent) {
+      throw new Error('missing userAgent');
+    }
+    if (this.existingPartsInUserAgent.some((part) => !userAgent.includes(part))) {
+      return undefined;
+    }
+    if (this.notExistingPartsInUserAgent.some((part) => userAgent.includes(part))) {
+      return undefined;
+    }
+    return this.os;
+  }
+
+  private add(part: string, array: string[]): DetectorBuilder {
+    if (!part) {
+      throw new Error('part is empty or undefined');
+    }
+    if (this.existingPartsInUserAgent.includes(part)) {
+      throw new Error(`part ${part} is already included as existing part`);
+    }
+    if (this.notExistingPartsInUserAgent.includes(part)) {
+      throw new Error(`part ${part} is already included as not existing part`);
+    }
+    array.push(part);
+    return this;
+  }
+}

src/infrastructure/RuntimeEnvironment/BrowserOs/IBrowserOsDetector.ts

@@ -0,0 +1,5 @@
+import { OperatingSystem } from '@/domain/OperatingSystem';
+
+export interface IBrowserOsDetector {
+  detect(userAgent: string): OperatingSystem | undefined;
+}

src/infrastructure/RuntimeEnvironment/IRuntimeEnvironment.ts

@@ -0,0 +1,7 @@
+import { OperatingSystem } from '@/domain/OperatingSystem';
+
+export interface IRuntimeEnvironment {
+  readonly isDesktop: boolean;
+  readonly os: OperatingSystem | undefined;
+  readonly isNonProduction: boolean;
+}

src/infrastructure/RuntimeEnvironment/RuntimeEnvironment.ts

@@ -0,0 +1,46 @@
+import { OperatingSystem } from '@/domain/OperatingSystem';
+import { WindowVariables } from '@/infrastructure/WindowVariables/WindowVariables';
+import { IEnvironmentVariables } from '@/infrastructure/EnvironmentVariables/IEnvironmentVariables';
+import { EnvironmentVariablesFactory } from '@/infrastructure/EnvironmentVariables/EnvironmentVariablesFactory';
+import { BrowserOsDetector } from './BrowserOs/BrowserOsDetector';
+import { IBrowserOsDetector } from './BrowserOs/IBrowserOsDetector';
+import { IRuntimeEnvironment } from './IRuntimeEnvironment';
+
+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: IBrowserOsDetector = new BrowserOsDetector(),
+  ) {
+    if (!window) {
+      throw new Error('missing window');
+    }
+    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) {
+        this.os = browserOsDetector.detect(userAgent);
+      }
+    }
+  }
+}
+
+function getUserAgent(window: Partial<Window>): string {
+  return window?.navigator?.userAgent;
+}
+
+function isDesktop(window: Partial<WindowVariables>): boolean {
+  return window?.isDesktop === true;
+}