browser-commander 0.23.0 → 0.24.0

package/.jscpd-baseline.json

@@ -8,9 +8,11 @@
     "04b28d01d0bb47dc": 1,
     "04f605be138bc350": 1,
     "0796d358ad2562c3": 1,
+    "08e28c7706cdddd6": 1,
     "090a69d9528e4cdb": 1,
     "09694dc8fb9d683c": 1,
     "0a3459aad03492bb": 1,
+    "0ae281facb3c28dd": 1,
     "0b48b63049c42591": 1,
     "0b8c71391c107a5e": 1,
     "0ba2d165b56db0b3": 1,
@@ -18,19 +20,19 @@
     "0caa402c4eae32d8": 1,
     "0fd23be8410c2c95": 1,
     "0fe4f3b5e5e939b3": 1,
-    "1019ebbe7f07a5ad": 1,
     "119f429fe4d23e4a": 1,
+    "126a1cfe8f2264ce": 1,
     "1273365073edd790": 1,
-    "1296adc3c3128048": 1,
     "13c4b58d3ea0719b": 1,
     "14beedf656e57fba": 1,
     "150c8efe188ac225": 1,
     "16340a16ed52849e": 1,
+    "16e58ea67d8ef4e8": 1,
     "17c26c0db2d35ad1": 1,
     "193b46c0e7f72053": 1,
+    "19ff70fc80fad524": 1,
     "1ad4dc7e19a77f68": 1,
     "1c1baf1bc8ea0eae": 1,
-    "1cbd39b416a2b94b": 1,
     "1d61f5c49f12d2dc": 1,
     "1ef570563d4e5a08": 1,
     "1f2104c950b12a30": 1,
@@ -39,10 +41,11 @@
     "22755b35701c5bb6": 1,
     "2296c06fa00da254": 1,
     "229b903386b17538": 1,
+    "22cbd954358d25f8": 1,
+    "230bfe57cfda164d": 1,
     "2357ae472525f6bf": 1,
     "2394170c8a2a0e9a": 1,
     "23d2486c0e269b77": 1,
-    "24b29d9d78441dbd": 1,
     "266893ea7a511fe4": 1,
     "266b9cb95f783cdf": 1,
     "26bb09996580437c": 1,
@@ -53,27 +56,28 @@
     "2c0f8b5c6f28420b": 1,
     "2d2d6fd6c7c0f30d": 1,
     "2e70be24d2268673": 1,
-    "2f4c9810eae87d6f": 1,
+    "2e75ebb5fafa33a5": 1,
     "2f9e15467cc2f12a": 1,
     "30da9d4e83f1c939": 1,
     "3101802d3ea65339": 1,
+    "326f1ff9016e1e37": 1,
     "33357ce94e07cc4b": 1,
     "35cf2769645f3234": 1,
     "37bd4114d0089f49": 1,
-    "39eaada6d1879f4a": 1,
+    "39cf8134a7fdaa31": 1,
     "3a9f1672ecc1d55b": 1,
     "3adca52a3f04837c": 1,
     "3c1017def7b3216c": 1,
-    "3da23cbee214a1a5": 1,
-    "3dced48baf70eb36": 1,
+    "3c5cb4b62d3739e3": 1,
     "3fa2ebbb416120f0": 1,
     "3fe61c0a7772f18b": 1,
     "406fed8e5b39aafd": 1,
     "40aa2953f783819c": 1,
     "418db56376cc23bd": 1,
+    "421bb16fafde32a7": 1,
     "441570d51d6f70a4": 1,
     "457c71f32f53833d": 1,
-    "46e3f58cfb14a43a": 1,
+    "4715a17d690865ee": 1,
     "4b0d3cc5c27227e7": 1,
     "4c3b94caa28045d0": 1,
     "4e090d6bb30e6551": 1,
@@ -84,29 +88,28 @@
     "520a28ee2ced56c2": 1,
     "53519ec61a6ba319": 1,
     "53f7e3f3e444a37d": 1,
-    "5587ec0cdb7b96e6": 1,
+    "55fd990468b1fd0f": 1,
     "562ebfb882d4aa8f": 1,
     "56b5df15ee61887d": 1,
     "56b7675e4ce57335": 1,
-    "56d45d447baad2fd": 1,
     "56deee57166c4369": 1,
     "578ab1469dc998ec": 1,
+    "57aa3b487de27c90": 1,
     "57c410b183671eec": 1,
-    "57e313e36a5ce81d": 1,
+    "5825f31d55b82fae": 1,
     "58c08b8242c875ec": 1,
     "58c1ca12d4d2b50f": 1,
     "5a09e2677334ba05": 1,
-    "5ae9b1430fc38daf": 1,
-    "602bfd129bba900e": 1,
+    "5b5d3f792532356c": 1,
+    "5ba2f3218754f04c": 1,
+    "60052da86e7bb241": 1,
     "608e1dd27138ec6f": 1,
-    "6098544c77ff17a2": 1,
     "60d0c58a01fc8746": 1,
     "61ae5da6cc003836": 1,
     "61bcadcd8dc9f63e": 1,
     "63ff613b1780c67a": 1,
     "642cc89ed49f8a21": 1,
     "6479c3604c153ec4": 1,
-    "6699064d6e8e09ba": 1,
     "66fb97eebd7ff0dc": 1,
     "67a95e428b8fa31c": 1,
     "6880d620e0e67229": 1,
@@ -127,7 +130,7 @@
     "760d9925f6e3ca85": 1,
     "7623a3eea4680be4": 1,
     "771db68809cce310": 1,
-    "771ddbb36a118cbb": 1,
+    "77793566535b942e": 1,
     "779517ed59b39aa6": 1,
     "7850ccac58d09216": 1,
     "785d557d0683185b": 1,
@@ -137,78 +140,89 @@
     "799dc9940577a15e": 1,
     "79e705499ddaf44b": 1,
     "7e6bad380644f9b0": 1,
+    "80cc77491cde09e5": 1,
+    "80f564fe45f6b315": 1,
     "81a56c10bfd42e39": 1,
     "837ba752ecdaf052": 1,
-    "8549c997a472cb6c": 1,
     "86646647aab19e39": 1,
     "8678919f1350f154": 1,
     "86aae81b1aa0d21b": 1,
     "87484a2744e09748": 1,
-    "876d2c8edfc8c40a": 1,
     "8b013ac20e436d76": 1,
     "8c2b1408886c1db1": 1,
+    "8e55579a412bc058": 1,
     "8ec18cdbd4a96518": 1,
+    "901317bc4d7d30d0": 1,
     "91049efadc65169b": 1,
     "9134185980de8a17": 1,
     "916833bafca4fa63": 1,
     "91a538e4a0c28f25": 1,
     "92ddafa7e65be7eb": 1,
     "94821a4d1b745dfd": 1,
+    "961e3cc731bbc9fe": 1,
     "97c5a112fdde7be8": 1,
     "990d87f21678fa96": 1,
     "9a72b1c2f22156ca": 1,
     "9b6ef4df04562546": 1,
-    "9ee57dcd5e7a6691": 1,
+    "9e049e3eefca1869": 1,
     "9fbb8296259dedbe": 1,
+    "9fe73b5b918293fe": 1,
     "a0183465782b0b15": 1,
+    "a11079d40b28716c": 1,
+    "a133391f90bd1a28": 1,
     "a1e3a3a13b27dba4": 1,
     "a1ef39a15701c2b5": 1,
     "a2a00d268fb2cee4": 1,
-    "a305c6cac16f3af5": 1,
+    "a36f66312d5bfbf8": 1,
     "a4c8498d4f2d2191": 1,
+    "a5298242b5439858": 1,
     "a6ad7ab6c05656dc": 1,
     "a6ffab1aacd00af6": 1,
     "a78d76908162699e": 1,
     "a9bd4ffef6da5faf": 1,
-    "a9d71c2e50f1b832": 1,
     "acc95d694eb2f581": 1,
     "ad4cfa76daa1b6fc": 1,
     "ad50b48938af8aef": 1,
-    "adae1329361a81a1": 1,
     "ae477ba64bafba3f": 1,
     "aee1e5c65f783848": 1,
     "aee45e8b58c2d87f": 1,
     "af702b20ebd45ef2": 1,
     "af9d6a2f4eba146e": 1,
     "b010686af23efa90": 1,
-    "b2a0686231220c8a": 1,
     "b35ff46c365dcd18": 1,
     "b41581af204af40e": 1,
     "b71fa5250da28739": 1,
     "b740ecac685a15fe": 1,
     "b8c2d21f2a26f77d": 1,
+    "ba675900dc4211b1": 1,
     "bb269582b94ed42d": 1,
     "bb3e6d0f7e7edccd": 1,
+    "bb5b0c8d22c9667a": 1,
     "bc9115be3a462930": 1,
     "bd0ae42c13d5b4f9": 1,
-    "bd6c62a6e1c6a071": 1,
+    "bd17b166d89cb709": 1,
     "bdb8ca169be36b80": 1,
     "bdcd11c2bfb5fde0": 1,
     "be0900fb3e87164e": 1,
     "bf452b9431c092ad": 1,
     "c0b027bebd7bd737": 1,
     "c189fe5122a7dc91": 1,
+    "c225b9d7d519303e": 1,
     "c2c155adbcb46f3c": 1,
     "c30737d62069fc02": 1,
     "c3c3569357673af8": 1,
     "c415ffcd004d6518": 1,
     "c461a83b51eb7740": 1,
+    "c5c202c5db4dd601": 1,
+    "c714beebc66381dd": 1,
     "c9cf3c28bed33a5b": 1,
+    "ca7e08d1eec2ad8c": 1,
     "cab590a1d04b5a05": 1,
     "cbd444e9a6a9072e": 1,
     "cebff7d1cc87f646": 1,
-    "cf6116d195199f8a": 1,
+    "cfc928aa393146b6": 1,
     "cfd68135b744c27b": 1,
+    "cfdc0cca50233fcb": 1,
     "d016035b3bf3340c": 1,
     "d097f41a6f43e634": 1,
     "d0da8714c4b7de30": 1,
@@ -220,26 +234,27 @@
     "d6157a86fea41907": 1,
     "d6fa9884eee815f0": 1,
     "d86bafb915488255": 1,
+    "da2c10a66acdb52f": 1,
+    "dabb9fc09638e178": 1,
     "de0bf2317c53d427": 1,
     "de1b481bfe8c3e58": 1,
     "df2dc922f40485e7": 1,
     "df3b85f6947db144": 1,
-    "e0b90bce5112bb9c": 1,
     "e2ef7800deb0f464": 1,
     "e3111b845acb7a0e": 1,
-    "e4b10b56d7e1edac": 1,
     "e59733bafda785e9": 1,
     "e5feedc0c24e103e": 1,
     "e67726a913675120": 1,
+    "e686288f2e9b8a6d": 1,
     "ea1195048ded896c": 1,
     "ea88711c5deb1fe5": 1,
     "eb9a70c2a21094ff": 1,
     "ebe03c5f8c2f5147": 1,
     "ee19c8b9b332ee98": 1,
     "eeca0ccf8d821f21": 1,
-    "ef2fc2e92ac07c6e": 1,
     "f022b763ff342b2d": 1,
     "f07f979f8c2706e8": 1,
+    "f186f73c118b8e8a": 1,
     "f38f72095a67c95e": 1,
     "f40ba84763547f41": 1,
     "f46509ed693574df": 1,
@@ -248,10 +263,13 @@
     "f6678d6748e9c902": 1,
     "f67a07a611f39cb2": 1,
     "f7b1f9d699bcd580": 1,
+    "f81e07af5d3a1c3c": 1,
+    "f904844f89cab699": 1,
     "f911821aa7dda47f": 1,
     "f97bf515bfd95829": 1,
     "fae844842fba705b": 1,
     "faf76ec43b2dbbaa": 1,
+    "fc0d7bde0033411d": 1,
     "fc6ed7d760c98f51": 1,
     "fccfd8b004c12dd4": 1,
     "fe859df9f97c75d4": 1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.24.0
+
+### Minor Changes
+
+- 31d2387: Support Selenium through the common launch, connection, CLI, and browser-test
+  APIs, including raw WebDriver handles and generic engine constructors. Refresh
+  all direct dependencies and generated engine APIs to the latest stable releases.
+
 ## 0.23.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,9 @@
 # Browser Commander
 
-A universal browser automation library for JavaScript/TypeScript that supports both Playwright and Puppeteer with a unified API. The key focus is on **stoppable page triggers** - ensuring automation logic is properly mounted/unmounted during page navigation.
+A universal browser automation library for JavaScript/TypeScript that supports Playwright, Puppeteer, and Selenium with a unified API. The key focus is on **stoppable page triggers** - ensuring automation logic is properly mounted/unmounted during page navigation.
+
+See [engine support and native/CLI defaults](../docs/engine-support.md) for the
+cross-language API matrix and Selenium examples.
 
 ## Installation
 
@@ -222,7 +225,7 @@ await saveStorageState(page, './gmail-state.json');
 `browser-commander/tests` adds browser fixtures and scheduling helpers on top of
 [`test-anywhere`](https://github.com/link-foundation/test-anywhere). It keeps
 tests portable across Node.js, Bun, and Deno while running the same browser
-scenario against Playwright and Puppeteer.
+scenario against Playwright, Puppeteer, and Selenium.
 
 ```javascript
 import { assert, browserTest } from 'browser-commander/tests';
@@ -467,6 +470,12 @@ console.log(session.migration.migrated, session.migration.skipped);
 
 ### launchWebDriver(options) / connectWebDriver(options)
 
+The same engine is available through `launchBrowser({engine: 'selenium'})` and
+`connectBrowser({engine: 'selenium', serverUrl, capabilities})`. The common
+launcher defaults to a real Chrome attachment; `launch: 'engine'` enables
+ChromeDriver/GeckoDriver-managed Chrome or Firefox launches. Both return a common
+page facade plus a raw `driver` and `close()`.
+
 The `selenium` engine drives Chrome or Firefox over W3C WebDriver through
 `selenium-webdriver` (an optional peer dependency). `launchWebDriver()` finds a
 driver (`driverPath`, then `PATH`, then the Selenium Manager bundled with
@@ -1032,7 +1041,7 @@ echo '{"jsonrpc":"2.0","id":1,"method":"version"}' | npx browser-commander serve
 
 The other commands are `open`, `click`, `screenshot`, `pdf`, `trace start|stop|view`, `cookies import`, `profile migrate` and `doctor`. Use the `=` form for values that start with `--`, for example `--arg=--lang=de`.
 
-`serve --stdio` exposes the high-level methods (`session.launch`, `page.goto`, …). It also exposes generic handle methods (`handle.root`, `handle.call`, `handle.get`, `handle.describe`, `events.subscribe`, …), which reach every public Playwright and Puppeteer method. The Rust and Python ports use this bridge for the engines they do not implement natively.
+`serve --stdio` exposes the high-level methods (`session.launch`, `page.goto`, …). It also exposes generic handle methods (`handle.root`, `handle.call`, `handle.get`, `handle.describe`, `events.subscribe`, …), which reach public Playwright, Puppeteer, and Selenium methods and constructors. The Rust and Python ports use this bridge for the engines they do not implement natively.
 
 For raw Chrome DevTools Protocol access from JavaScript, `createCdpSession(page)` (or `commander.createCdpSession()`) returns the same `send`/`on`/`once`/`off`/`detach` surface for Playwright and Puppeteer pages.
 

package/eslint.config.js

@@ -154,7 +154,7 @@ export default [
     ignores: [
       'node_modules/**',
       'coverage/**',
-      'dist/**',
+      '**/dist/**',
       'docs-api/**',
       '*.min.js',
       '.eslintcache',