feat(launcher): add new CLI flags, clear user data, and unsaved changes guard (#99)

* refactor: rename BotBrowserConsole to BotBrowserLauncher

* feat: add kernel management, proxy management, and setup scripts

* fix: enable macOS native Edit menu for Cmd+C/V/X/A keyboard shortcuts

* chore: upgrade Neutralino runtime to 6.4.0

* chore: remove Neutralino binaries from repo, download via neu update

* fix: improve macOS clipboard support with JS fallback for Cmd+V paste

* fix: expand macOS clipboard fallback to Cmd+C/X, auto-download Neutralino via postinstall

* chore: upgrade Neutralino to 6.5.0 and simplify setup scripts

* fix: fix PowerShell setup script ZIP download corruption

* feat: enhance proxy workflow with IP check, quick change, and reusable input component

* fix: correct checkbox color override and setup script stdin handling

* feat: improve profile deletion with auto-stop, group WebRTC settings, prioritize custom exec path

* feat: add port protection toggle, fix kernel auto-update cleanup and UI refresh

* fix: detect kernel assets by file extension to support renamed Windows/Linux packages

* fix: handle non-browser process exits, add crash detection, validate kernel executable paths

* docs: add --bot-time-seed documentation, changelog 2026-03-03, value range and per-context cross-links

* feat: add proxy save/check, improve table layout and kernel date display

- Add "Save to proxy list" button in proxy input for reusing manually entered proxies
- Add batch proxy connectivity check with IP/status display in proxy management
- Sort proxy list by creation time (newest first)
- Fix kernel date display: parse from asset filename, fix timezone offset bug
- Simplify profile status column to icon-only (play/stop) with tooltips
- Remove year from "Last Launch" date to prevent truncation
- Widen window to 1080px, use fixed table layout to prevent horizontal scrollbar
- Add column width constraints for profile and proxy tables

* feat: redesign profile editor with left nav, advanced config modes, and new fields

- Add left-side anchor navigation with scrollspy (IntersectionObserver)
- Split Fingerprint into separate Noise and Rendering sections
- Replace expansion panel with flat Advanced section layout
- Add mode toggles for Executable (kernel/custom), Cookies and Bookmarks (file/input)
- Add FPS dropdown (profile/real/custom number) instead of free-text input
- Add Save IP button in proxy section for explicit IP saving
- Add new fields: Time Seed, Proxy Bypass Regex, Cookies, Bookmarks, Custom Headers
- Put username/password on same row in proxy input
- Widen status column to prevent icon clipping

* fix: replace Save IP with Save to proxy list, unify dropdown option labels

* fix: include username and password in proxy duplicate detection

Normalize both sides with `|| ''` to handle undefined values, and add
password to the comparison so proxies with the same host:port but
different credentials are treated as distinct entries.

* fix: prevent editing running profiles and remove auto-save IP on proxy check

- Block profile editing when browser is running/launching/stopping,
  show alert dialog instead of silently darkening the background
- Remove onIpCheckResult that auto-saved checked IP to proxyIp field

* feat(launcher): add automatic self-update with GitHub commit tracking

Check for launcher updates on startup and every hour by comparing
the local commit hash against the latest launcher-specific commit
from GitHub API (path=launcher). When an update is found, silently
download, rebuild, and prompt the user to restart.

- Add UpdateService with periodic check, ZIP download, and rebuild
- Show update status (checking/downloading/building/ready) in sidebar
- Display current version (commit hash) at sidebar bottom
- Update setup scripts to save commit hash after install/build
- Fix sidebar footer layout to stay at bottom via flex container

* feat(launcher): improve table UX, add new CLI flags, and proxy input enhancements

- Separate row highlight (single click) from checkbox selection (batch ops)
- Add double-click to edit on both profile and proxy tables
- Add clear proxy button in profile editor
- Combine proxy type/host/port into single row layout
- Add --bot-stack-seed and --bot-network-info-override CLI flags
- Update noise seed from float to integer range
- Stack seed uses dropdown (profile/real/custom) like FPS
- Rearrange noise settings: seed+scale+timeseed row, fps+stackseed row
- Widen proxy type column in proxy list table

* fix(launcher): auto-highlight new profiles/proxies and default noise text rects off

- Return created profile/proxy ID from dialog so the table highlights
  the new row after creation, matching the edit-then-highlight behavior
- Change botConfigNoiseTextRects default from on to off

* feat(launcher): add new CLI flags, clear user data, and unsaved changes guard

- Add --bot-config-orientation dropdown in Display & Input section with all orientation variants, noted as mobile profiles only
- Add --bot-gpu-emulation toggle in Behavior section for auto GPU rendering backend selection
- Add "Clear User Data" action in both profile edit dialog and profile list context menu to delete user-data-dir
- Guard profile and proxy edit dialogs against accidental close: Escape, backdrop click, and Cancel now prompt when forms have unsaved changes

Author: mykola-zalizniak

launcher/src/app/app.component.html

@@ -255,6 +255,10 @@
                                                     <mat-icon>local_fire_department</mat-icon>
                                                     <span>Warmup</span>
                                                 </button>
+                                                <button mat-menu-item (click)="clearUserData(element)">
+                                                    <mat-icon>delete_sweep</mat-icon>
+                                                    <span>Clear User Data</span>
+                                                </button>
                                             }
                                         </mat-menu>
                                     </div>

launcher/src/app/app.component.ts

@@ -287,6 +287,31 @@ export class AppComponent implements AfterViewInit {
         }
     }
 
+    clearUserData(browserProfile: BrowserProfile): void {
+        this.#dialog
+            .open(ConfirmDialogComponent, {
+                data: {
+                    message: `Clear user data for "${browserProfile.basicInfo.profileName}"? This deletes cookies, cache, local storage, and all browsing data. The profile settings will be kept.`,
+                },
+            })
+            .afterClosed()
+            .subscribe(async (result: boolean) => {
+                if (!result) return;
+
+                try {
+                    const userDataDirPath = await this.#browserProfileService.getBrowserProfileUserDataDirPath(browserProfile);
+                    await Neutralino.filesystem.remove(userDataDirPath);
+                } catch (error) {
+                    // Directory may not exist yet, which is fine
+                    console.log('Clear user data:', error);
+                }
+
+                this.#dialog.open(AlertDialogComponent, {
+                    data: { message: 'User data cleared successfully.' },
+                });
+            });
+    }
+
     async refreshProfiles(): Promise<void> {
         this.loading = true;
         try {

launcher/src/app/data/browser-profile.ts

@@ -67,6 +67,10 @@ export const MediaTypesOptions: MediaTypesOption[] = ['expand', 'profile', 'real
 export type ColorScheme = 'light' | 'dark';
 export const ColorSchemes: ColorScheme[] = ['light', 'dark'];
 
+// Orientation options
+export type OrientationOption = 'profile' | 'landscape' | 'portrait' | 'landscape-primary' | 'landscape-secondary' | 'portrait-primary' | 'portrait-secondary';
+export const OrientationOptions: OrientationOption[] = ['profile', 'landscape', 'portrait', 'landscape-primary', 'landscape-secondary', 'portrait-primary', 'portrait-secondary'];
+
 // Behavior toggles
 export interface BehaviorToggles {
     botLocalDns?: boolean;
@@ -77,6 +81,7 @@ export interface BehaviorToggles {
     botDisableConsoleMessage?: boolean;
     botPortProtection?: boolean;
     botNetworkInfoOverride?: boolean;
+    botGpuEmulation?: boolean;
 }
 
 // Identity & Locale config
@@ -107,6 +112,7 @@ export interface DisplayInputConfig {
     botConfigScreen?: ProfileReal;
     botConfigKeyboard?: ProfileReal;
     botConfigFonts?: FontOption;
+    botConfigOrientation?: OrientationOption;
     botConfigColorScheme?: ColorScheme;
     botConfigDisableDeviceScaleFactor?: boolean;
 }

launcher/src/app/edit-browser-profile.component.html

@@ -286,6 +286,17 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                             }
                         </mat-select>
                     </mat-form-field>
+
+                    <mat-form-field class="flex-1">
+                        <mat-label>Orientation</mat-label>
+                        <mat-select formControlName="botConfigOrientation">
+                            <mat-option value="">Default</mat-option>
+                            @for (opt of orientationOptions; track opt) {
+                                <mat-option [value]="opt">{{ opt }}</mat-option>
+                            }
+                        </mat-select>
+                        <mat-hint>Mobile profiles only (Android/iPhone/iPad)</mat-hint>
+                    </mat-form-field>
                 </div>
 
                 <mat-slide-toggle formControlName="botConfigDisableDeviceScaleFactor" class="standalone-toggle">
@@ -499,6 +510,11 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                     Network Info Override
                     <span class="toggle-hint">Use profile-defined navigator.connection values (default: off)</span>
                 </mat-slide-toggle>
+
+                <mat-slide-toggle formControlName="botGpuEmulation">
+                    GPU Emulation
+                    <span class="toggle-hint">Auto-select optimal GPU rendering backend (default: off)</span>
+                </mat-slide-toggle>
             </form>
         </div>
 
@@ -600,7 +616,12 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
     </div>
 </mat-dialog-content>
 <mat-dialog-actions align="end">
-    <button mat-button mat-dialog-close>Cancel</button>
+    @if (isEdit) {
+        <button mat-button color="warn" (click)="clearUserData()">
+            Clear User Data
+        </button>
+    }
+    <button mat-button (click)="onCancel()">Cancel</button>
     <button mat-button cdkFocusInitial (click)="onConfirmClick()">
         {{ isEdit ? 'Save' : 'Create' }}
     </button>

launcher/src/app/edit-browser-profile.component.ts

@@ -23,6 +23,7 @@ import {
     ColorSchemes,
     FontOptions,
     MediaTypesOptions,
+    OrientationOptions,
     Platforms,
     ProfileRealDisabledOptions,
     ProfileRealOptions,
@@ -109,6 +110,7 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
     readonly fontOptions = FontOptions;
     readonly mediaTypesOptions = MediaTypesOptions;
     readonly colorSchemes = ColorSchemes;
+    readonly orientationOptions = OrientationOptions;
 
     readonly basicInfoFormGroup = this.#formBuilder.group<BasicInfo>({
         profileName: this.#injectedData?.basicInfo.profileName || 'New Profile',
@@ -155,6 +157,7 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
         botDisableConsoleMessage: this.#injectedData?.launchOptions?.behavior?.botDisableConsoleMessage ?? true,
         botPortProtection: this.#injectedData?.launchOptions?.behavior?.botPortProtection,
         botNetworkInfoOverride: this.#injectedData?.launchOptions?.behavior?.botNetworkInfoOverride,
+        botGpuEmulation: this.#injectedData?.launchOptions?.behavior?.botGpuEmulation,
     });
 
     // Identity & Locale - default: browserBrand=chrome
@@ -185,6 +188,7 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
         botConfigScreen: this.#injectedData?.launchOptions?.displayInput?.botConfigScreen ?? 'real',
         botConfigKeyboard: this.#injectedData?.launchOptions?.displayInput?.botConfigKeyboard ?? 'profile',
         botConfigFonts: this.#injectedData?.launchOptions?.displayInput?.botConfigFonts ?? 'profile',
+        botConfigOrientation: this.#injectedData?.launchOptions?.displayInput?.botConfigOrientation,
         botConfigColorScheme: this.#injectedData?.launchOptions?.displayInput?.botConfigColorScheme ?? 'light',
         botConfigDisableDeviceScaleFactor:
             this.#injectedData?.launchOptions?.displayInput?.botConfigDisableDeviceScaleFactor,
@@ -299,6 +303,13 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
     async ngOnInit() {
         // Load proxies
         this.proxies = await this.#proxyService.getAllProxies();
+
+        // Unsaved changes guard
+        this.#dialogRef.disableClose = true;
+        this.#dialogRef.backdropClick().subscribe(() => this.#confirmClose());
+        this.#dialogRef.keydownEvents().subscribe((event) => {
+            if (event.key === 'Escape') this.#confirmClose();
+        });
     }
 
     ngAfterViewInit() {
@@ -533,6 +544,39 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
         });
     }
 
+    onCancel(): void {
+        this.#confirmClose();
+    }
+
+    #isFormDirty(): boolean {
+        return (
+            this.basicInfoFormGroup.dirty ||
+            this.behaviorGroup.dirty ||
+            this.identityLocaleGroup.dirty ||
+            this.customUserAgentGroup.dirty ||
+            this.displayInputGroup.dirty ||
+            this.noiseGroup.dirty ||
+            this.renderingMediaGroup.dirty ||
+            this.proxyConfigGroup.dirty ||
+            this.advancedConfigGroup.dirty
+        );
+    }
+
+    #confirmClose(): void {
+        if (!this.#isFormDirty()) {
+            this.#dialogRef.close();
+            return;
+        }
+        this.#dialog
+            .open(ConfirmDialogComponent, {
+                data: { message: 'You have unsaved changes. Discard and close?' },
+            })
+            .afterClosed()
+            .subscribe((result: boolean) => {
+                if (result) this.#dialogRef.close();
+            });
+    }
+
     #handleFileSelection(filePath: string): void {
         Neutralino.filesystem
             .readFile(filePath)
@@ -583,6 +627,30 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
         return true;
     }
 
+    clearUserData(): void {
+        if (!this.#injectedData) return;
+        const profile = this.#injectedData;
+        this.#dialog
+            .open(ConfirmDialogComponent, {
+                data: {
+                    message: `Clear user data for "${profile.basicInfo.profileName}"? This deletes cookies, cache, local storage, and all browsing data. The profile settings will be kept.`,
+                },
+            })
+            .afterClosed()
+            .subscribe(async (result: boolean) => {
+                if (!result) return;
+                try {
+                    const userDataDirPath = await this.#browserProfileService.getBrowserProfileUserDataDirPath(profile);
+                    await Neutralino.filesystem.remove(userDataDirPath);
+                } catch (error) {
+                    console.log('Clear user data:', error);
+                }
+                this.#dialog.open(AlertDialogComponent, {
+                    data: { message: 'User data cleared successfully.' },
+                });
+            });
+    }
+
     async onConfirmClick(): Promise<void> {
         console.log('onConfirmClick called');
 

launcher/src/app/proxy-management/edit-proxy.component.html

@@ -17,6 +17,6 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'New' }} Proxy</h2>
 </mat-dialog-content>
 
 <mat-dialog-actions align="end">
-    <button mat-button mat-dialog-close>Cancel</button>
+    <button mat-button (click)="onCancel()">Cancel</button>
     <button mat-flat-button color="primary" (click)="onConfirmClick()">Confirm</button>
 </mat-dialog-actions>

launcher/src/app/proxy-management/edit-proxy.component.ts

@@ -1,13 +1,14 @@
 import { CommonModule } from '@angular/common';
-import { Component, inject } from '@angular/core';
+import { Component, inject, type OnInit } from '@angular/core';
 import { FormBuilder, ReactiveFormsModule } from '@angular/forms';
 import { MatButtonModule } from '@angular/material/button';
-import { MAT_DIALOG_DATA, MatDialogModule, MatDialogRef } from '@angular/material/dialog';
+import { MAT_DIALOG_DATA, MatDialog, MatDialogModule, MatDialogRef } from '@angular/material/dialog';
 import { MatFormFieldModule } from '@angular/material/form-field';
 import { MatInputModule } from '@angular/material/input';
 import { v4 as uuidv4 } from 'uuid';
 import type { Proxy, ProxyType } from '../data/proxy';
 import type { ParsedProxy } from '../shared/proxy-parser.service';
+import { ConfirmDialogComponent } from '../shared/confirm-dialog.component';
 import { ProxyInputComponent } from '../shared/proxy-input.component';
 import { ProxyService } from '../shared/proxy.service';
 
@@ -26,8 +27,9 @@ import { ProxyService } from '../shared/proxy.service';
     templateUrl: './edit-proxy.component.html',
     styleUrl: './edit-proxy.component.scss',
 })
-export class EditProxyComponent {
+export class EditProxyComponent implements OnInit {
     readonly #proxyService = inject(ProxyService);
+    readonly #dialog = inject(MatDialog);
     readonly #dialogRef = inject(MatDialogRef<EditProxyComponent>);
     readonly #injectedData = inject<Proxy | undefined>(MAT_DIALOG_DATA);
     readonly #formBuilder = inject(FormBuilder);
@@ -50,6 +52,14 @@ export class EditProxyComponent {
 
     #currentProxyValue: ParsedProxy | null = this.proxyValue;
 
+    ngOnInit(): void {
+        this.#dialogRef.disableClose = true;
+        this.#dialogRef.backdropClick().subscribe(() => this.#confirmClose());
+        this.#dialogRef.keydownEvents().subscribe((event) => {
+            if (event.key === 'Escape') this.#confirmClose();
+        });
+    }
+
     onProxyValueChange(value: ParsedProxy | null): void {
         this.#currentProxyValue = value;
 
@@ -59,6 +69,34 @@ export class EditProxyComponent {
         }
     }
 
+    onCancel(): void {
+        this.#confirmClose();
+    }
+
+    #confirmClose(): void {
+        if (!this.nameFormGroup.dirty && !this.#hasProxyChanged()) {
+            this.#dialogRef.close();
+            return;
+        }
+        this.#dialog
+            .open(ConfirmDialogComponent, {
+                data: { message: 'You have unsaved changes. Discard and close?' },
+            })
+            .afterClosed()
+            .subscribe((result: boolean) => {
+                if (result) this.#dialogRef.close();
+            });
+    }
+
+    #hasProxyChanged(): boolean {
+        const orig = this.proxyValue;
+        const curr = this.#currentProxyValue;
+        if (!orig && !curr) return false;
+        if (!orig || !curr) return true;
+        return orig.type !== curr.type || orig.host !== curr.host || orig.port !== curr.port
+            || orig.username !== curr.username || orig.password !== curr.password;
+    }
+
     async onConfirmClick(): Promise<void> {
         const proxyData = this.#currentProxyValue;
         if (!proxyData?.host || !proxyData?.port) return;

launcher/src/app/shared/browser-launcher.service.ts

@@ -279,6 +279,7 @@ export class BrowserLauncherService {
         if (opts?.behavior?.botDisableConsoleMessage) args.push('--bot-disable-console-message');
         if (opts?.behavior?.botPortProtection) args.push('--bot-port-protection');
         if (opts?.behavior?.botNetworkInfoOverride) args.push('--bot-network-info-override');
+        if (opts?.behavior?.botGpuEmulation) args.push('--bot-gpu-emulation');
 
         // Identity & Locale
         if (opts?.identityLocale?.botConfigBrowserBrand)
@@ -320,6 +321,8 @@ export class BrowserLauncherService {
             args.push(`--bot-config-keyboard=${opts.displayInput.botConfigKeyboard}`);
         if (opts?.displayInput?.botConfigFonts)
             args.push(`--bot-config-fonts=${opts.displayInput.botConfigFonts}`);
+        if (opts?.displayInput?.botConfigOrientation)
+            args.push(`--bot-config-orientation=${opts.displayInput.botConfigOrientation}`);
         if (opts?.displayInput?.botConfigColorScheme)
             args.push(`--bot-config-color-scheme=${opts.displayInput.botConfigColorScheme}`);
         if (opts?.displayInput?.botConfigDisableDeviceScaleFactor)