feat(api): replace always-on-top with native picture-in-picture

BREAKING CHANGE: Removed setupAlwaysOnTopMain, setupAlwaysOnTopRender, and cleanupAlwaysOnTopMain exports. Applications using these APIs must migrate to setupPictureInPictureMain and setupPictureInPictureRender.

Replace custom always-on-top window implementation with browser's native picture-in-picture API to provide a lighter-weight solution with better OS integration. The native PiP eliminates the need for custom window management code, reduces maintenance overhead, and provides users with a familiar, OS-native experience for keeping the active speaker visible while multitasking.

The new implementation:
- Uses Electron's userGesture privileges to bypass transient activation requirements
- Communicates between renderer and main process via IPC
- Requires minimal setup compared to the previous custom window approach
- Leverages browser's built-in PiP capabilities for better performance

Version bumped to 8.0.0 due to breaking API changes.

Author: hristoterezov

CLAUDE.md

@@ -38,7 +38,7 @@ The SDK is organized into feature-based modules that expose both **main process*
 index.js (main export)
 ├── remotecontrol/       # Remote desktop control via robotjs
 ├── screensharing/       # Screen sharing with desktop picker and tracker
-├── alwaysontop/         # Floating active speaker window
+├── pip/                 # Picture-in-picture for active speaker video
 ├── powermonitor/        # System idle and power events
 ├── popupsconfig/        # Popup window configuration registry
 ├── node_addons/         # Native C++ addons (Windows only)
@@ -69,11 +69,12 @@ Custom screen/window picker and sharing tracker:
 - Special handling for Wayland (uses native picker) and macOS (permission checks)
 - `screenSharingTracker.js`: Small always-visible window showing "X is sharing your screen"
 
-#### Always On Top (`alwaysontop/`)
-Floating window showing active speaker when main window loses focus:
-- Uses Chrome's window.open implementation (requires `nativeWindowOpen: true`)
-- Window identified by `frameName: 'AlwaysOnTop'`
-- EventEmitter API with `dismissed` and `will-close` events
+#### Picture in Picture (`pip/`)
+Browser native picture-in-picture functionality for active speaker video:
+- `setupPictureInPictureMain`: Runs in main process, handles IPC requests and executes PiP with userGesture privileges
+- `setupPictureInPictureRender`: Runs in renderer, listens for `_pipRequested` events from Jitsi Meet iframe API
+- Uses IPC channel `jitsi-pip-channel` for communication between processes
+- Bypasses transient activation requirements by executing PiP from main process
 
 #### Power Monitor (`powermonitor/`)
 Queries system idle state and power events:

README.md

@@ -81,47 +81,39 @@ const {
 setupScreenSharingMain(mainWindow, appName, osxBundleId);
 ```
 
+#### Picture in Picture
 
-#### Always On Top
-Displays a small window with the current active speaker video when the main Jitsi Meet window is not focused.
+Enables the browser's native picture-in-picture functionality for the active speaker video. This allows users to keep the active speaker video visible in a floating window while using other applications.
 
 **Requirements**:
-1. Jitsi Meet should be initialized through our [iframe API](https://github.com/jitsi/jitsi-meet/blob/master/doc/api.md)
-2. The `BrowserWindow` instance where Jitsi Meet is displayed should use the [Chrome's window.open implementation](https://github.com/electron/electron/blob/master/docs/api/window-open.md#using-chromes-windowopen-implementation) (set `nativeWindowOpen` option of `BrowserWindow`'s constructor to `true`).
-3. If you have a custom handler for opening windows you have to filter the always on top window. You can do this by its `frameName` argument which will be set to `AlwaysOnTop`.
+1. Jitsi Meet should be initialized through the [iframe API](https://github.com/jitsi/jitsi-meet/blob/master/doc/api.md)
+2. The feature requires Electron's main process to execute the PiP request with userGesture privileges to bypass browser security restrictions
 
-**Enable the aways on top:**
+**Enable picture in picture:**
 
 In the **main** electron process:
+
 ```Javascript
 const {
-    setupAlwaysOnTopMain
+    setupPictureInPictureMain
 } = require("@jitsi/electron-sdk");
 
-// jitsiMeetWindow - The BrowserWindow instance
-// of the window where Jitsi Meet is loaded.
-setupAlwaysOnTopMain(jitsiMeetWindow);
+// jitsiMeetWindow - The BrowserWindow instance where Jitsi Meet is loaded.
+// loggerTransports - Optional array of logger transports for configuring the logger.
+const pipMain = setupPictureInPictureMain(jitsiMeetWindow, loggerTransports);
 ```
 
 In the **render** electron process of the window where Jitsi Meet is displayed:
+
 ```Javascript
 const {
-    setupAlwaysOnTopRender
+    setupPictureInPictureRender
 } = require("@jitsi/electron-sdk");
 
 const api = new JitsiMeetExternalAPI(...);
-const alwaysOnTop = setupAlwaysOnTopRender(api);
-
-alwaysOnTop.on('will-close', handleAlwaysOnTopClose);
+const pipRender = setupPictureInPictureRender(api);
 ```
 
-`setupAlwaysOnTopRender` return an instance of EventEmitter with the following events:
-
-* _dismissed_ - emitted when the always on top window is explicitly dismissed via its close button
-
-* _will-close_ - emitted right before the always on top window is going to close
-
-
 #### Power Monitor
 
 Provides a way to query electron for system idle and receive power monitor events.
@@ -148,12 +140,6 @@ const api = new JitsiMeetExternalAPI(...);
 setupPowerMonitorRender(api);
 ```
 
-### NOTE:
-You'll need to add 'disable-site-isolation-trials' switch because of [https://github.com/electron/electron/issues/18214](https://github.com/electron/electron/issues/18214):
-```
-app.commandLine.appendSwitch('disable-site-isolation-trials')
-```
-
 ## Example
 
 For examples of installation and usage checkout the [Jitsi Meet Electron](https://github.com/jitsi/jitsi-meet-electron) project.