[java][bidi] Add BiDi code generator

.github/workflows/bazel.yml

@@ -32,7 +32,7 @@ on:
         type: boolean
         default: false
       node-version:
-        description: Custom Node version to install
+        description: Custom Node version to use
         required: false
         type: string
         default: ''
@@ -91,11 +91,17 @@ on:
         required: false
         type: boolean
         default: false
+    outputs:
+      output:
+        description: Value the run script writes to $GITHUB_OUTPUT as "output=..."; empty when unused
+        value: ${{ jobs.bazel.outputs.output }}
 
 jobs:
   bazel:
     name: ${{ inputs.name }}
     runs-on: ${{ contains(inputs.os, '-') && inputs.os || format('{0}-latest', inputs.os) }}
+    outputs:
+      output: ${{ steps.run-bazel.outputs.output }}
     env:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       SEL_M2_USER: ${{ secrets.SEL_M2_USER }}
@@ -182,11 +188,9 @@ jobs:
       - name: Set Ruby version
         if: inputs.ruby-version != ''
         run: echo '${{ inputs.ruby-version }}' > rb/.ruby-version
-      - name: Setup Node
+      - name: Set Node version
         if: inputs.node-version != ''
-        uses: actions/setup-node@v6
-        with:
-          node-version: ${{ inputs.node-version }}
+        run: echo '${{ inputs.node-version }}' > .nvmrc
       - name: Setup Bazel with caching
         continue-on-error: true
         timeout-minutes: 10

.github/workflows/ci-dotnet.yml

@@ -31,6 +31,7 @@ jobs:
       name: Browser Tests
       os: windows
       needs-display: true
+      rerun-with-debug: true
       run: |
         bazel test //dotnet/test/webdriver:ElementFindingTests-firefox //dotnet/test/webdriver:ElementFindingTests-chrome
 
@@ -41,5 +42,6 @@ jobs:
       name: Remote Tests
       os: windows
       needs-display: true
+      rerun-with-debug: true
       run: |
         bazel test //dotnet/test/remote --flaky_test_attempts=3

.github/workflows/ci-javascript.yml

@@ -0,0 +1,30 @@
+name: CI - JavaScript
+
+on:
+  workflow_call:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build
+    uses: ./.github/workflows/bazel.yml
+    with:
+      name: Build
+      run: bazel build //javascript/selenium-webdriver
+
+  unit-tests:
+    name: Unit Tests
+    uses: ./.github/workflows/bazel.yml
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: ['22.22.0', '24.14.1']
+        os: [ubuntu]
+    with:
+      name: Unit Tests (${{ matrix.node-version }}, ${{ matrix.os }})
+      os: ${{ matrix.os }}
+      node-version: ${{ matrix.node-version }}
+      run: bazel test --local_test_jobs 1 //javascript/selenium-webdriver:small-tests

.github/workflows/ci-ruby.yml

@@ -2,6 +2,12 @@ name: CI - Ruby
 
 on:
   workflow_call:
+    inputs:
+      smoke:
+        description: Run smoke tests only (callers pass false to run the full matrix)
+        required: false
+        type: boolean
+        default: true
   workflow_dispatch:
     inputs:
       smoke:
@@ -25,7 +31,7 @@ jobs:
   # covers truffleruby and the most recent MRI release.
   unit-tests:
     name: Unit Tests
-    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && !inputs.smoke)
+    if: github.event_name == 'schedule' || !inputs.smoke
     uses: ./.github/workflows/bazel.yml
     strategy:
       fail-fast: false
@@ -48,7 +54,7 @@ jobs:
 
   smoke:
     name: ${{ matrix.os }}-smoke
-    if: github.event_name != 'schedule' && (github.event_name != 'workflow_dispatch' || inputs.smoke)
+    if: github.event_name != 'schedule' && inputs.smoke
     uses: ./.github/workflows/bazel.yml
     strategy:
       fail-fast: false
@@ -79,7 +85,7 @@ jobs:
 
   os-tests-full:
     name: ${{ matrix.os }}-full
-    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && !inputs.smoke)
+    if: github.event_name == 'schedule' || !inputs.smoke
     uses: ./.github/workflows/bazel.yml
     strategy:
       fail-fast: false

.github/workflows/ci.yml

@@ -39,7 +39,7 @@ jobs:
         [ "${{ github.event_name }}" == "workflow_call" ] || \
         [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
           echo "Running all targets for ${{ github.event_name }} event"
-          echo "//java/... //py/... //rb/... //dotnet/... //rust/..." > bazel-targets.txt
+          echo "//java/... //py/... //rb/... //dotnet/... //rust/... //javascript/..." > bazel-targets.txt
         else
           if [ -n "${{ github.event.pull_request.base.sha }}" ]; then
             BASE_SHA="HEAD^1"
@@ -70,6 +70,7 @@ jobs:
       rb: ${{ steps.read.outputs.rb }}
       dotnet: ${{ steps.read.outputs.dotnet }}
       rust: ${{ steps.read.outputs.rust }}
+      js: ${{ steps.read.outputs.js }}
     steps:
       - name: Download targets
         uses: actions/download-artifact@v8
@@ -101,6 +102,7 @@ jobs:
           check_binding "openqa/selenium/grid" "grid"
           check_binding "//dotnet" "dotnet"
           check_binding "//rust" "rust"
+          check_binding "//javascript" "js"
           process_binding "//rb" "rb"
           process_binding "//py" "py"
       - name: Upload target files
@@ -138,6 +140,8 @@ jobs:
     needs: read-targets
     uses: ./.github/workflows/ci-ruby.yml
     if: needs.read-targets.outputs.rb != ''
+    with:
+      smoke: ${{ !(github.head_ref == 'pinned-browser-updates' && contains(github.event.pull_request.title, '(major)')) }}
 
   rust:
     name: Rust
@@ -147,10 +151,16 @@ jobs:
       SELENIUM_CI_TOKEN: ${{ secrets.SELENIUM_CI_TOKEN }}
     if: needs.read-targets.outputs.rust != ''
 
+  javascript:
+    name: JavaScript
+    needs: read-targets
+    uses: ./.github/workflows/ci-javascript.yml
+    if: needs.read-targets.outputs.js != ''
+
   ci-success:
     name: CI Success
     if: always()
-    needs: [check, read-targets, dotnet, java, grid, python, ruby, rust]
+    needs: [check, read-targets, dotnet, java, grid, python, ruby, rust, javascript]
     runs-on: ubuntu-latest
     steps:
       - name: Verify required jobs succeeded

.github/workflows/pin-browsers.yml

@@ -13,7 +13,7 @@ jobs:
     uses: ./.github/workflows/bazel.yml
     with:
       name: Pin Browsers
-      run: bazel run //scripts:pinned_browsers
+      run: ./scripts/github-actions/update_browsers.sh
       artifact-name: pinned-browsers
 
   create-pr:
@@ -49,9 +49,9 @@ jobs:
           commit-message: "Update pinned browser versions"
           author: Selenium CI Bot <selenium-ci@users.noreply.github.com>
           base: trunk
-          title: "[build] Automated Browser Version Update"
+          title: "[build] Automated Browser Version Update${{ contains(needs.update.outputs.output, 'major') && ' (major)' || '' }}${{ contains(needs.update.outputs.output, 'cdp') && ' with CDP' || '' }}"
           body: |
-            This is an automated pull request to update pinned browsers and drivers
+            This is an automated pull request to update pinned browsers and drivers.${{ contains(needs.update.outputs.output, 'major') && ' Major Chrome/Firefox bump: CI runs the full Ruby matrix.' || '' }}${{ contains(needs.update.outputs.output, 'cdp') && ' Chrome DevTools (CDP) was regenerated to match.' || '' }}
 
             Merge after verifying the new browser versions are properly passing the tests
           branch: "pinned-browser-updates"

.github/workflows/release.yml

@@ -141,7 +141,7 @@ jobs:
       name: Publish ${{ matrix.language }}
       gpg-sign: ${{ matrix.language == 'java' }}
       gem-trusted-publishing: ${{ matrix.language == 'ruby' }}
-      node-version: ${{ matrix.language == 'javascript' && '24' || '' }}
+      node-version: ${{ matrix.language == 'javascript' && '24.14.1' || '' }}
       run: |
         if [ "${{ matrix.language == 'java' && (needs.parse-tag.outputs.language == 'all' || needs.parse-tag.outputs.language == 'java') && github.run_attempt > 1 }}" = "true" ]; then
           echo "::error::Java release is not yet rerun-safe — check/drop the staging repo at https://central.sonatype.com/publishing/deployments and publish manually"

.nvmrc

@@ -0,0 +1 @@
+22.22.0

AGENTS.md

@@ -14,7 +14,7 @@ The repository README is aimed at contributors; end-user docs live elsewhere.
 - If `.local/agent/skills/` exists, inspect its `*/SKILL.md` files and treat them as additional user-defined skills.
 
 ## Invariants (don't violate unless explicitly asked)
-- Maintain API/ABI compatibility - users upgrade by changing only version number
+- Maintain API/ABI compatibility by default (users upgrade by changing only the version number); public functionality may be removed only after it has gone through the [Deprecation policy](#deprecation-policy) below
 - Avoid repo-wide refactors/formatting; prefer small, reversible diffs
 
 ## Toolchain

MODULE.bazel

@@ -60,6 +60,15 @@ single_version_override(
     ],
 )
 
+# Patch support for bazel-contrib/rules_ruby#393 remove in next rules_ruby release
+single_version_override(
+    module_name = "rules_ruby",
+    patch_strip = 1,
+    patches = [
+        "//third_party/bazel:rules_ruby_windows_batch_crlf.patch",
+    ],
+)
+
 multitool = use_extension("@rules_multitool//multitool:extension.bzl", "multitool")
 multitool.hub(lockfile = "//:multitool.lock.json")
 use_repo(multitool, "multitool")
@@ -76,7 +85,7 @@ linter.configure(
 linter.register(name = "rust-rustfmt")
 
 node = use_extension("@rules_nodejs//nodejs:extensions.bzl", "node")
-node.toolchain(node_version = "22.22.0")
+node.toolchain(node_version_from_nvmrc = "//:.nvmrc")
 
 pnpm = use_extension(
     "@aspect_rules_js//npm:extensions.bzl",

common/bidi/BUILD.bazel

@@ -0,0 +1,4 @@
+exports_files(
+    glob(["*.cddl"]),
+    visibility = ["//javascript/selenium-webdriver:__pkg__"],
+)

common/bidi/webdriver-bidi-1140.cddl

@@ -0,0 +1,8 @@
+; Local copy of w3c/webdriver-bidi#1140: adds the webExtension.install extension point.
+; Overrides the upstream closed InstallParameters. Delete once #1140 merges and the
+; pinned webref carries it. https://github.com/w3c/webdriver-bidi/pull/1140
+webExtension.InstallParameters = {
+  extensionData: webExtension.ExtensionData,
+  webExtension.InstallParametersExtension,
+}
+webExtension.InstallParametersExtension = ( Extensible )

common/bidi/webextension-install-extensions.cddl

@@ -0,0 +1,7 @@
+; Firefox vendor fields for webExtension.install, matching Mozilla's agreed CDDL (bug 2057588,
+; pending merge). Once it lands, repoint vendor_cddl_files at Mozilla's file and delete this.
+; https://bugzilla.mozilla.org/show_bug.cgi?id=2057588
+webExtension.InstallParametersExtension //= (
+  ? "moz:allowPrivateBrowsing": bool .default false,
+  ? "moz:permanent": bool .default false,
+)