docs: reflect 2025-11-17 changelog across CLI flags, advanced features, and profile configs

Author: MSTU0

ADVANCED_FEATURES.md

@@ -244,13 +244,18 @@ Eliminates host‑specific rendering differences for accurate cross‑platform e
 - macOS profile runs authentically on Windows/Linux hosts
 - Android profile fully emulated on any desktop OS
 - Consistent behavior regardless of host operating system
+- Android DevTools panes stay readable under emulation—the inspector now ignores page zoom/font scaling so toolbars and monospace panes match real devices
 
 **Rendering Consistency:**
 - Eliminates host OS rendering artifacts
 - Platform-specific UI element simulation
 - Consistent touch/mouse event patterns
 - Authentic device behavior emulation
 
+### Touch & Input Reliability
+- Pointer/touch bridging fixes ensure `Input.dispatchMouseEvent` and synthesized taps land reliably, even in nested iframe trees
+- Mobile flows keep consistent tap timing and coordinates when `mobileForceTouch` is enabled, avoiding accidental double dispatches
+
 ### Hardware Fingerprint Control
 Comprehensive hardware emulation and fingerprint management.
 

CLI_FLAGS.md

@@ -165,7 +165,7 @@ BotBrowser now supports command-line flags that override profile configuration v
 The following `--bot-config-*` flags map directly to profile `configs`:
 
 ```bash
---bot-config-browser-brand=chrome             # Browser brand: chrome, chromium, edge, brave
+--bot-config-browser-brand=chrome             # Browser brand: chrome, chromium, edge, brave, opera
 --bot-config-color-scheme=light               # Color scheme: light, dark
 --bot-config-disable-debugger=true            # Disable JavaScript debugger: true, false
 --bot-config-disable-device-scale-factor=true # Disable device scale factor: true, false
@@ -186,6 +186,7 @@ The following `--bot-config-*` flags map directly to profile `configs`:
 --bot-config-screen=profile                   # Screen properties: profile (use profile), real (system screen)
 --bot-config-speech-voices=profile            # Speech voices: profile (synthetic), real (system voices)
 --bot-config-timezone=auto                    # Timezone: auto (IP-based), real (system), or timezone name
+--bot-config-brand-full-version=142.0.3595.65 # Brand-specific full version (Edge/Opera cadence) for UA-CH congruence
 --bot-config-ua-full-version=142.0.7444.60    # User agent version: full version string matching Chromium major
 --bot-config-webgl=profile                    # WebGL: profile (use profile), real (system), disabled (off)
 --bot-config-webgpu=profile                   # WebGPU: profile (use profile), real (system), disabled (off)
@@ -196,7 +197,7 @@ The following `--bot-config-*` flags map directly to profile `configs`:
 --bot-config-mobile-force-touch=false         # Mobile touch: force touch events on/off for mobile device simulation
 ```
 
-> **Note — UA/Engine Congruence:** For `--bot-config-ua-full-version`, use a value that matches the Chromium major version in your build, and keep brands/`userAgentData` aligned to avoid fingerprint mismatches.
+> **Note — UA/Engine Congruence:** Keep `--bot-config-ua-full-version` aligned with your Chromium major version, and use `--bot-config-brand-full-version` when a vendor’s cadence (Edge, Opera, Brave) diverges so UA-CH metadata stays internally consistent.
 
 ### Key Benefits of CLI Configuration Flags
 
@@ -205,11 +206,11 @@ The following `--bot-config-*` flags map directly to profile `configs`:
 - **Dynamic Configuration:** Perfect for automation and CI/CD
 - **Session Isolation:** Different settings per instance
 
-### Spotlight: BotBrowser v142 20251031 Additions
+### Spotlight: BotBrowser v142 20251117 Additions
 
-- **Chromium 142.0.7444.60 base** — aligns rendering, networking, and security surfaces with the current Chrome stable channel.
-- **`--bot-config-disable-console-message`** — silences console output to keep CDP logging noise out of page scripts and production logs.
-- **`--bot-config-fonts=expand`** — loads supplemental system fonts when profiles lack coverage to improve authenticity while keeping profile baselines.
+- **Chromium 142.0.7444.163 base** — keeps rendering, networking, and storage surfaces in lockstep with Chrome Stable for minimum version skew.
+- **`--bot-config-brand-full-version`** — decouples UA full version and brand cadence so Edge/Opera style UA-CH tuples remain believable.
+- **Opera brand mode** — `--bot-config-browser-brand=opera` mirrors Opera UA-CH data and branding, while Brave parity fixes hide disallowed fields exactly like the real browser.
 
 ### Configuration Priority
 

profiles/PROFILE_CONFIGS.md

@@ -47,7 +47,8 @@ BotBrowser uses a three-tier priority system for configuration:
 chromium-browser \
   --no-sandbox \
   --bot-profile="/absolute/path/to/profile.enc" \
-  --bot-config-browser-brand="edge"
+  --bot-config-browser-brand="edge" \
+  --bot-config-brand-full-version="142.0.3595.65"
 ```
 
 > 📖 **Complete CLI flags reference:** [CLI Flags Reference](../CLI_FLAGS.md#⚙️-profile-configuration-override-flags)
@@ -90,7 +91,8 @@ All configurations are embedded in the `configs` field inside your profile JSON
 | `disableConsoleMessage`         | Suppresses console message forwarding into page contexts and automation logs.            | `true`     |
 | `timezone`                      | `auto` = IP-based; `real` = system timezone; any other string = custom timezone name. | `auto`    |
 | `location`                      | `auto` = IP-based; `real` = system (GPS); object = custom coordinates (`lat`, `lon`). | `auto`    |
-| `browserBrand`                  | override for `navigator.userAgentData.brands` and related UA fields. Supports chromium, chrome, edge, brave. | `chrome`    |
+| `browserBrand`                  | override for `navigator.userAgentData.brands` and related UA fields. Supports chromium, chrome, edge, brave, opera. | `chrome`    |
+| `brandFullVersion`              | Optional brand-specific full version string for UA-CH tuples (Edge/Opera cadences). | `""`    |
 | `injectRandomHistory`           | Optionally injects synthetic navigation history for academic experiments in browser state testing. | `false`    |
 | `disableDebugger`               | Prevents unintended interruptions from JavaScript debugger statements during automated academic workflows. | `true`     |
 | `keyboard`                      | Choose keyboard fingerprint source: `profile` (emulated from profile) or `real` (use system keyboard). | `profile` |
@@ -230,9 +232,12 @@ All configurations are embedded in the `configs` field inside your profile JSON
     // noiseTextRects: Introduce controlled variance to TextRects for academic fingerprint resilience testing
     "noiseTextRects": true,
 
-    // browserBrand: override for `navigator.userAgentData.brands` and related UA fields. Supports "chromium", "chrome", "edge", "brave"
+    // browserBrand: override for `navigator.userAgentData.brands` and related UA fields. Supports "chromium", "chrome", "edge", "brave", "opera"
     "browserBrand": "chrome",
 
+    // brandFullVersion: optional brand-specific full version string for UA-CH tuples when the vendor’s cadence diverges
+    "brandFullVersion": "142.0.3595.65",
+
     // injectRandomHistory: Optionally injects synthetic navigation history for academic experiments in browser state testing
     "injectRandomHistory": false,
 
@@ -290,6 +295,7 @@ All configurations are embedded in the `configs` field inside your profile JSON
 - If a field is omitted, BotBrowser uses profile defaults where appropriate.
 - CLI `--bot-config-*` flags override profile `configs` with the highest priority
 - **uaFullVersion Tip:** When JavaScript calls `navigator.userAgentData.fullVersion`, BotBrowser replaces the default value with this field. Ensure the full version matches the Chromium major version (e.g., Chromium 138 → full version starts with “138.”). See https://chromiumdash.appspot.com/releases.
+- **brandFullVersion Tip:** Pair this with `browserBrand` when mimicking Edge/Opera/Brave cadences so UA-CH tuples expose the vendor’s own full-version token instead of the Chromium one.
 
 ---