craftdriver 1.0.3 → 1.1.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+# [1.1.0](https://github.com/dtopuzov/craftdriver/compare/v1.0.4...v1.1.0) (2026-07-09)
+
+
+### Features
+
+* add browserPath to launch a custom browser binary (Chrome/Chromium/Firefox) ([127d11d](https://github.com/dtopuzov/craftdriver/commit/127d11d9db2877d764253c7359c543abcef8fd0c))
+* auto-detect CI-provided driver directories (GitHub Actions) ([bcd389f](https://github.com/dtopuzov/craftdriver/commit/bcd389f4e180e32cc034e0ace61898195f8f7837))
+
+
+### Performance Improvements
+
+* measure CI-detection savings vs the PATH-probe/version-detect fallback ([a64c2df](https://github.com/dtopuzov/craftdriver/commit/a64c2df51f14be71c791b6c4549f5827df9abb2e))
+
+## [1.0.4](https://github.com/dtopuzov/craftdriver/compare/v1.0.3...v1.0.4) (2026-07-09)
+
+
+### Bug Fixes
+
+* bound session creation with a request timeout ([5b67d24](https://github.com/dtopuzov/craftdriver/commit/5b67d2496293ad174540c33bd827b2b262fc0d5a))
+* isolate driver downloads to per-call temp dirs ([11e38ad](https://github.com/dtopuzov/craftdriver/commit/11e38adfb4e65a6b6787cb35f89c2570ed7cd339))
+
 ## [1.0.3](https://github.com/dtopuzov/craftdriver/compare/v1.0.2...v1.0.3) (2026-07-07)
 
 
@@ -124,6 +145,7 @@ Fixes: https://github.com/dtopuzov/craftdriver/issues/20
 
 ## Unreleased
 
+- docs: refresh the README as a product front door, add a VitePress documentation site with GitHub Pages deployment, add proof pages/launch kit/social card, and add contribution files (issue forms, PR template, code of conduct).
 - **breaking** (pre-1.0): BiDi console/error log capture is lazy by default. Messages emitted before the first `browser.logs` / `onConsole` / `onError` / `waitForConsole` touch are no longer captured unless `Browser.launch({ captureLogs: true })` is used to arm logging at launch.
 - feat(launch): add `Browser.launch({ args })` for opt-in browser flags, forwarded to `goog:chromeOptions.args` for Chrome/Chromium and `moz:firefoxOptions.args` for Firefox. Craftdriver still sets no performance flags by default.
 - perf(bidi): reduce the issue #20 BiDi/Classic per-command regression by routing common `waitUntil: 'load'` navigations through Classic when safe, batching BiDi connect-time work into one parallel `getTree` + `session.subscribe` batch, removing three redundant context-event subscriptions, making log capture lazy, and pooling Classic HTTP connections with keep-alive. New `npm run bench` harnesses cover the light flow, heavier registration-shaped flow, launch critical path, and optional real-app registration flow.
@@ -134,8 +156,8 @@ Fixes: https://github.com/dtopuzov/craftdriver/issues/20
 - fix(driver-manager): stale cached chromedriver auto-resolution now self-heals after a Chrome major-version update. If session creation reports the classic "ChromeDriver only supports Chrome version X" mismatch and the running driver came from the auto-resolution cache, craftdriver clears that metadata entry, stops the stale service, and retries launch once so users do not wait up to the 24h TTL.
 - refactor(timing): centralize poll intervals, default timeouts, fixed delays, and retry policy in `src/lib/timing.ts`; route `expect(...)` matchers through one shared polling helper; and DRY the driver-resolution TTL metadata helpers.
 - docs: refresh BiDi/protocol guidance, lazy-log docs, driver-resolution performance guidance, route-handler examples, dialog/emulation transport notes, mouse signatures, storage-origin wording, and contributor setup now that drivers auto-download.
-- chore(deps): pin the vendored npm used by `@semantic-release/npm` to a version that bundles patched `undici`, clearing the dev/release-tooling audit finding without changing craftdriver runtime dependencies.
-- fix(security): clamp user-supplied `timeout` and `idleDuration` values passed to `setTimeout` in `waitForNetworkIdle` (network.ts) and `waitForLoadState` (browser.ts) to prevent resource exhaustion from unbounded timer durations (CodeQL high-severity alerts). The `ms()` helper in `dispatcher.ts` (the socket→number boundary for the CLI daemon) now also caps at 300,000 ms so the sanitization happens at the untrusted-input boundary rather than deep in the call chain. Caps: 300,000 ms for timeouts, 60,000 ms for idle durations.
+- chore(deps): pin the vendored npm used by `@semantic-release/npm` to a version that bundles patched `undici`, clearing the dev/release-tooling finding without changing craftdriver runtime dependencies.
+- fix: clamp user-supplied `timeout` and `idleDuration` values passed to `setTimeout` in `waitForNetworkIdle` (network.ts) and `waitForLoadState` (browser.ts) to prevent resource exhaustion from unbounded timer durations. The `ms()` helper in `dispatcher.ts` (the socket→number boundary for the CLI daemon) now also caps at 300,000 ms so the sanitization happens at the untrusted-input boundary rather than deep in the call chain. Caps: 300,000 ms for timeouts, 60,000 ms for idle durations.
 - fix(tests): `driver-manager.test.ts` integration test was silently short-circuiting on systems where `chromedriver` is already on `PATH` (ubuntu-latest CI runners, nvm-managed Node envs). The resolution chain hit the PATH probe at step 5 before ever reaching the auto-download step, so nothing was written to the cache directory and the cache assertions failed. Fix: `beforeAll` now filters chromedriver-containing directories out of `PATH` to force the download path; `PATH` is restored in `afterAll`.
 
 - fix(browser-context): `page.context()` now returns `browser.defaultContext` for pages opened via `browser.openPage()` / `browser.waitForPage()` / `browser.pages()` / `browser.activePage()` instead of `undefined`. Previously these pages lived in the default user context at the BiDi layer but had no owner wired up, which meant `page.navigateTo('/foo')` silently ignored the default context's `baseURL`, and the model leaked. New regression test in [tests/browser-context-hooks.test.ts](tests/browser-context-hooks.test.ts).
@@ -183,7 +205,7 @@ Fixes: https://github.com/dtopuzov/craftdriver/issues/20
 - **breaking** (pre-1.0): `KeyboardController` / `MouseController` renamed to `Keyboard` / `Mouse` for Playwright parity. Re-exported from `src/index.ts`.
 - feat: `By.text(text, { exact: false })` is now sugar for `By.partialText(text)`. `getByText` and `By.text` share one vocabulary.
 - docs: dedicated [docs/dialogs.md](docs/dialogs.md); browser-api dialogs section trimmed to a callout. Attached-vs-visible gloss added to the waiting section. `By.role({ includeHidden })` documented in [docs/selectors.md](docs/selectors.md). `browser.actions()` gets a runnable shift-drag example in [docs/browser-api.md](docs/browser-api.md).
-- docs: BiDi-feature matrix added at the top of [docs/bidi-features.md](docs/bidi-features.md), timeout-defaults table added in [docs/browser-api.md](docs/browser-api.md), mobile-emulation Chrome-only callout promoted to the top of [docs/mobile-emulation.md](docs/mobile-emulation.md), cleanup / failure-recovery guidance added to [docs/browser-api.md](docs/browser-api.md).
+- docs: feature-availability notes added to the browser capability docs, timeout-defaults table added in [docs/browser-api.md](docs/browser-api.md), mobile-emulation Chrome-only callout promoted to the top of [docs/mobile-emulation.md](docs/mobile-emulation.md), cleanup / failure-recovery guidance added to [docs/browser-api.md](docs/browser-api.md).
 - feat: re-export `Keyboard` and `Mouse` (was `KeyboardController` / `MouseController`) from [src/index.ts](src/index.ts).
 - **breaking** (pre-1.0): remove deprecated aliases `Browser.waitForNewContext()` and `LogMonitor.getConsoleLogs()`. One API per concept; no aliases pre-1.0.
 - **breaking** (pre-1.0): rename `By.nameAttr` → `By.name` and `By.tag` → `By.tagName` for parity with Selenium's canonical `By` API.

package/README.md

@@ -1,208 +1,128 @@
-# Craftdriver 🍺🍺🍺
+# CraftDriver 🍺
 
 [![CI](https://github.com/dtopuzov/craftdriver/actions/workflows/ci.yml/badge.svg)](https://github.com/dtopuzov/craftdriver/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/craftdriver.svg)](https://www.npmjs.com/package/craftdriver)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/craftdriver.svg)](https://www.npmjs.com/package/craftdriver)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-2563eb.svg)](https://dtopuzov.github.io/craftdriver/)
+[![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-43853d.svg)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-f59e0b.svg)](./LICENSE)
 
-Crafted Node.js browser automation built directly on the WebDriver protocols.
+Crafted Node.js browser automation built on W3C WebDriver and BiDi.
 
-**Playwright's ergonomics. WebDriver's standards-compliance. AI-ready.**
+**Playwright-style ergonomics. WebDriver standards. AI friendly.**
 
-Auto-waiting, semantic locators, network mocking, session management, mobile emulation, and more.
+CraftDriver is for writing boringly reliable automation against real browsers, with code that reads nicely.
 
-Based on W3C specs, so your tests stay stable across real browsers.
+## Why CraftDriver?
 
-Ships AI productivity tooling out of the box: CLI, MCP, assistant bootstrap files, and packaged skill docs — no extra packages required.
+- 🍺 **Focused Node.js API** - browser automation without a giant framework around it.
+- 🧭 **Real browsers** - drives installed Chrome, Chromium, and Firefox instead of patched browser engine builds.
+- 🌐 **Standards that age well** - W3C WebDriver standards stay stable while browser-private protocols change.
+- 🚦 **Readable, auto-waited flows** - role, label, text, test id, CSS, XPath, click, fill, and expect.
+- 📡 **Network control** - mock, block, intercept, and wait for browser requests and responses.
+- 🔐 **Reusable sessions** - save cookies and localStorage, then launch already signed in.
+- ⏱️ **Virtual clock** - freeze or fast-forward `Date`, timers, and time-sensitive UI.
+- ♿ **Accessibility audits** - run axe-core checks on pages, elements, and locators.
+- 🧾 **Trace evidence** - capture actions, console output, errors, network events, and screenshots.
+- 🤖 **Agent-friendly** - CLI, MCP, and assistant rules when coding agents need the browser.
 
-## Getting started
+## Choose Your Path
+
+| You want to...                    | Start here                                                                |
+| --------------------------------- | ------------------------------------------------------------------------- |
+| Write browser automation          | [Getting started](https://dtopuzov.github.io/craftdriver/getting-started) |
+| Give an AI coding agent a browser | [AI agent guide](https://dtopuzov.github.io/craftdriver/agents)           |
+
+## Quick Start
 
 ```bash
 npm install craftdriver --save-dev
 ```
 
-That's it.
-No drivers, no extra steps to install browsers.
-
-Quick example:
-
 ```ts
 import { Browser } from 'craftdriver';
 
 const browser = await Browser.launch({ browserName: 'chrome' });
 
-await browser.navigateTo('https://example.com');
-await browser.fill('#username', 'alice');
-await browser.fill('#password', 'hunter2');
-await browser.click('#submit');
+await browser.navigateTo('https://example.com/login');
+await browser.getByLabel('Username').fill('alice');
+await browser.getByLabel('Password').fill('hunter2');
+await browser.getByRole('button', { name: 'Sign in' }).click();
 await browser.expect('#result').toHaveText('Welcome alice');
 
 await browser.quit();
 ```
 
-Mobile emulation:
+No separate chromedriver or geckodriver setup for normal use. CraftDriver resolves and caches the right driver for your installed browser.
 
-```ts
-const browser = await Browser.launch({
-  browserName: 'chrome',
-  mobileEmulation: 'iPhone 14',
-});
+## AI Agent Bonus
+
+If your coding agent can use a shell or MCP, CraftDriver can give it a real browser too. Same selectors, same behavior, same error codes as the library API.
+
+```bash
+npx craftdriver init agents
+claude mcp add craftdriver -- npx -y craftdriver mcp
 ```
 
-Network mocking (BiDi is on by default):
+See the [AI agent guide](https://dtopuzov.github.io/craftdriver/agents) when you need the full setup.
+
+## What It Can Do
 
 ```ts
-const browser = await Browser.launch({ browserName: 'chrome' });
+// Mobile emulation
+await Browser.launch({
+  browserName: 'chrome',
+  mobileEmulation: 'iPhone 14',
+});
 
+// Network mocking
 await browser.network.mock('**/api/users', {
   status: 200,
   body: { users: [] },
 });
-```
-
-Session persistence:
 
-```ts
+// Save and reuse login state
 await browser.saveState('./session.json');
 
-// Later: restore cookies and localStorage in one shot
-const browser2 = await Browser.launch({
+await Browser.launch({
   browserName: 'chrome',
   storageState: './session.json',
 });
-```
-
-## AI Productivity Tooling
-
-`craftdriver` ships three surfaces for AI agents (Copilot, Claude
-Code, Cursor, Codex, Gemini CLI, …), in addition to the library:
-
-If you want Craftdriver to work well with coding agents on day one, this is the stack: a shell-friendly CLI, an MCP server for tool-calling hosts, packaged skills, and `craftdriver init` to drop the right repo instructions into place.
-
-- **CLI** (this section) — a `craftdriver` binary for shell-capable agents.
-- **Skill pack** — ready-to-load rules at [skills/craftdriver/](./skills/craftdriver/),
-  shipped in the npm tarball.
-- **MCP server** — stdio JSON-RPC for sandboxed hosts. See below.
-- **`craftdriver init`** — drop per-project rules files for the popular
-  assistants (Copilot, Claude, Cursor, Gemini, Codex / AGENTS.md).
 
-All four share the same dispatcher, error codes, and selector syntax.
-
-The `craftdriver` binary is for shell scripts, ad-hoc exploration, and
-shell-capable AI agents. It wraps the same Browser API as the library,
-with fail-fast defaults tuned for probing instead of stable test runs.
-
-```bash
-# terminal 1 — keep a long-lived browser around
-npx craftdriver daemon start
-
-# terminal 2 — drive it
-npx craftdriver go http://127.0.0.1:8080/login.html
-npx craftdriver fill '#username' alice
-npx craftdriver fill '#password' hunter2
-npx craftdriver click 'button[type=submit]'
-npx craftdriver wait '#result' --state visible
-npx craftdriver text '#result'
-
-npx craftdriver daemon stop
-```
-
-State (page, cookies, storage) survives between calls — the CLI feels
-like a REPL for the browser. For sandboxed environments that can't keep
-a daemon, pipe a script through `--ephemeral` instead.
-
-Selectors are CSS by default; switch with a `prefix=value` form
-(`role=button[name=Submit]`, `text=Sign In`, `label=Email`,
-`placeholder=...`, `testid=...`, `xpath=...`). Output is pretty on a
-TTY and JSON when piped. Every error carries the same stable `code` and
-`hint:` as the library. See [docs/cli.md](./docs/cli.md) for the full
-command list and selector reference.
-
-### Teach your AI assistant
-
-`craftdriver init <flavor>` writes a short rules file into your project
-so Copilot, Claude, Cursor, Codex, Gemini, OpenCode, Aider, &hellip;
-pick up the right conventions on every turn (selector preference,
-auto-waiting, error codes, CLI usage). Per-project, checked into git,
-zero runtime cost.
-
-```bash
-npx craftdriver init copilot   # .github/copilot-instructions.md
-npx craftdriver init claude    # CLAUDE.md
-npx craftdriver init cursor    # .cursor/rules/craftdriver.mdc
-npx craftdriver init gemini    # GEMINI.md
-npx craftdriver init agents    # AGENTS.md (Codex, OpenCode, Aider, Amp, Cursor)
-npx craftdriver init all       # every file above
-```
-
-Use `--force` to overwrite existing files, `--dry-run` to preview.
-
-### Skill pack
-
-For agents that load skills explicitly (Claude Code's Skills system,
-Copilot agent customization, custom orchestrators), the npm tarball
-ships a tiered skill pack under [skills/craftdriver/](./skills/craftdriver/):
-
-- [`SKILL.md`](./skills/craftdriver/SKILL.md) — always-on, ≤ 500 tokens.
-  Decision rules: selector preference order, error-code-first error
-  handling, the auto-wait contract, when to reach for CLI/MCP.
-- [`cheatsheet.md`](./skills/craftdriver/cheatsheet.md) — command-by-command
-  reference for writing tests.
-- [`patterns.md`](./skills/craftdriver/patterns.md) — worked recipes
-  (login, upload, network-wait, a11y, tracing, virtual clock).
-- [`cli.md`](./skills/craftdriver/cli.md) — agent-facing CLI reference.
-
-Point your agent at `node_modules/craftdriver/skills/craftdriver/SKILL.md`
-(or copy the file into your project) and the rest is loaded on demand.
-
-### MCP server
-
-For agents that talk [Model Context Protocol](https://modelcontextprotocol.io)
-(Claude Desktop / Code, Cursor, Windsurf, Zed, Goose, Gemini CLI, …),
-`craftdriver mcp` exposes the same dispatcher as a stdio JSON-RPC
-server with 14 schema-typed tools. Mutating tools return a **compact
-a11y snapshot diffed from the previous turn** — the agent sees what
-changed on the page without a follow-up read.
-
-```bash
-# Claude Code
-claude mcp add craftdriver -- npx -y craftdriver mcp
+// Built-in accessibility checks via axe-core
+await browser.a11y.check();
 ```
 
-```jsonc
-// Cursor / Windsurf / Zed
-{
-  "mcpServers": {
-    "craftdriver": { "command": "npx", "args": ["-y", "craftdriver", "mcp"] }
-  }
-}
-```
-
-See [docs/mcp.md](./docs/mcp.md) for the full tool list, install
-snippets for every host, and the snapshot format.
-
 ## Feature Guide
 
-One table is enough here: what Craftdriver does, and where to learn the exact API.
-
-| Area | What you get | Learn more |
-| --- | --- | --- |
-| Getting started | Install, launch a browser, write the first test | [Getting Started](./docs/getting-started.md) |
-| Driver management | Zero-config driver download, cache behavior, env vars, offline mode | [Driver Configuration](./docs/driver-configuration.md) |
-| Browser control | Navigation, tabs, popups, iframes, content helpers, evaluate, init scripts | [Browser API](./docs/browser-api.md) |
-| Elements and locators | CSS, XPath, text, role, label, test id, and composable `locator()` chains | [Selectors](./docs/selectors.md) |
-| Element actions | Click, fill, upload, inspect, and interact through element handles | [Element API](./docs/element-api.md) |
-| Assertions and auto-waiting | Built-in `expect(...)`, retries, visibility, text, attributes, and timing behavior | [Assertions](./docs/assertions.md) |
-| Keyboard and mouse | Low-level key presses, mouse movement, hover, drag, and pointer input | [Keyboard & Mouse](./docs/keyboard-mouse.md) |
-| Dialogs | `alert`, `confirm`, `prompt`, and `beforeunload` handling | [Dialogs](./docs/dialogs.md) |
-| Sessions and storage | Cookies, localStorage, save/load state, persistent flows | [Session Management](./docs/session-management.md) |
-| Screenshots | Page and element screenshots for tests and debugging | [Screenshots](./docs/screenshots.md) |
-| Mobile and emulation | Device presets, viewport emulation, locale, timezone, offline, reduced motion | [Mobile Emulation](./docs/mobile-emulation.md), [Emulation](./docs/emulation.md) |
-| Browser contexts | Isolated profiles for multi-user and multi-session testing | [Browser Contexts](./docs/browser-context.md) |
-| BiDi features | Network mocking, request/response listeners, console logs, JS errors | [BiDi Features](./docs/bidi-features.md) |
-| Tracing and debugging | Crash-resilient NDJSON traces and evidence screenshots | [Tracing](./docs/tracing.md) |
-| Accessibility | Built-in axe-core audits for page, element, and locator scopes | [Accessibility](./docs/accessibility.md) |
-| Virtual time | Fake `Date`, `setTimeout`, and `setInterval` for time-sensitive flows | [Virtual Clock](./docs/clock.md) |
-| Agent surfaces | Shell CLI, MCP server, assistant bootstrap, and packaged skill files | [CLI](./docs/cli.md), [MCP server](./docs/mcp.md), [Skill pack](./skills/craftdriver/SKILL.md) |
+| Area                 | What you get                                                                       | Learn more                                                                                                                                 |
+| -------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| Getting started      | Install, launch a browser, write the first test                                    | [Getting started](https://dtopuzov.github.io/craftdriver/getting-started)                                                                  |
+| Driver management    | Zero-config driver resolution, cache behavior, env vars, offline mode              | [Driver configuration](https://dtopuzov.github.io/craftdriver/driver-configuration)                                                        |
+| Browser control      | Navigation, tabs, popups, iframes, content helpers, evaluate, init scripts         | [Browser API](https://dtopuzov.github.io/craftdriver/browser-api)                                                                          |
+| Locators             | CSS, XPath, text, role, label, test id, and composable `locator()` chains          | [Selectors](https://dtopuzov.github.io/craftdriver/selectors)                                                                              |
+| Element actions      | Click, fill, upload, inspect, and interact through element handles                 | [Element API](https://dtopuzov.github.io/craftdriver/element-api)                                                                          |
+| Assertions           | Built-in `expect(...)`, retries, visibility, text, attributes, and timing behavior | [Assertions](https://dtopuzov.github.io/craftdriver/assertions)                                                                            |
+| Input                | Low-level key presses, mouse movement, hover, drag, and pointer input              | [Keyboard and mouse](https://dtopuzov.github.io/craftdriver/keyboard-mouse)                                                                |
+| Dialogs              | `alert`, `confirm`, `prompt`, and `beforeunload` handling                          | [Dialogs](https://dtopuzov.github.io/craftdriver/dialogs)                                                                                  |
+| Sessions             | Cookies, localStorage, save/load state, persistent login flows                     | [Session management](https://dtopuzov.github.io/craftdriver/session-management)                                                            |
+| Network mocking      | Mock, block, intercept, and wait for browser requests and responses                | [Network mocking](https://dtopuzov.github.io/craftdriver/network)                                                                          |
+| Console and errors   | Capture console output and fail tests on JavaScript errors                         | [Console logs](https://dtopuzov.github.io/craftdriver/browser-logs)                                                                        |
+| Screenshots          | Page and element screenshots for tests and debugging                               | [Screenshots](https://dtopuzov.github.io/craftdriver/screenshots)                                                                          |
+| Mobile and emulation | Device presets, viewport, locale, timezone, offline, reduced motion                | [Mobile emulation](https://dtopuzov.github.io/craftdriver/mobile-emulation), [Emulation](https://dtopuzov.github.io/craftdriver/emulation) |
+| Browser contexts     | Isolated profiles for multi-user and multi-session testing                         | [Browser contexts](https://dtopuzov.github.io/craftdriver/browser-context)                                                                 |
+| Tracing              | Crash-resilient NDJSON traces and evidence screenshots                             | [Tracing](https://dtopuzov.github.io/craftdriver/tracing)                                                                                  |
+| Accessibility        | Built-in axe-core audits for page, element, and locator scopes                     | [Accessibility](https://dtopuzov.github.io/craftdriver/accessibility)                                                                      |
+| Virtual time         | Fake `Date`, `setTimeout`, and `setInterval` for time-sensitive flows              | [Virtual clock](https://dtopuzov.github.io/craftdriver/clock)                                                                              |
+| AI agents            | CLI, MCP server, assistant bootstrap, packaged skill files                         | [AI agent guide](https://dtopuzov.github.io/craftdriver/agents)                                                                            |
+
+## Links
+
+- [Documentation site](https://dtopuzov.github.io/craftdriver/)
+- [API reference](https://dtopuzov.github.io/craftdriver/api-reference)
+- [Recipes](https://dtopuzov.github.io/craftdriver/recipes)
+- [Changelog](./CHANGELOG.md)
+- [Contributing guide](./CONTRIBUTING.md)
 
 ## Contributing
 

package/dist/lib/browser.d.ts

@@ -178,6 +178,28 @@ export interface LaunchOptions {
      * `FirefoxService`.
      */
     args?: string[];
+    /**
+     * A custom **browser** binary to launch — Chrome, Chromium, or Firefox.
+     * Distinct from `chromeService`/`firefoxService`'s `binaryPath`, which names
+     * the *driver* (chromedriver/geckodriver), not the browser.
+     *
+     * When omitted, craftdriver resolves it from (first match wins):
+     *   1. `CRAFTDRIVER_CHROME_PATH` / `CRAFTDRIVER_FIREFOX_PATH` env var
+     *   2. `CRAFTDRIVER_BROWSER_PATH` env var (generic fallback — forwarded as-is
+     *      regardless of browser, so avoid it when launching both in one job)
+     *   3. `CHROME_BIN` / `FIREFOX_BIN` env var (common CI convention)
+     *   4. `SE_CHROME_PATH` / `SE_FIREFOX_PATH` env var (Selenium Manager convention)
+     *
+     * This option itself is opt-in, but steps 2–4 read ambient env vars other
+     * tools (Karma, Selenium Manager) may already export for their own
+     * purposes — if one happens to be set, craftdriver forwards it even though
+     * you never touched craftdriver config. If none resolve, craftdriver
+     * forwards nothing and chromedriver/geckodriver fall back to their own
+     * built-in browser discovery. An invalid candidate at any step logs a
+     * `[craftdriver]` note to stderr and falls through rather than failing
+     * silently. See "Browser Binary Configuration" in docs/driver-configuration.md.
+     */
+    browserPath?: string;
 }
 /**
  * When to consider a navigation complete.

package/dist/lib/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/lib/browser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/lib/browser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAS,MAAM,WAAW,CAAC;AAY1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAMvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,EAEL,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAU,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMnC,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IACxD,iEAAiE;IACjE,aAAa,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,IAAI,CAAC;IAClD,wDAAwD;IACxD,YAAY,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,mCAAmC;AACnC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCV,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAChD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,eAAe,GAAG,UAAU,CAAC;IAC/C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,MAAM,CAAC;AAE7E,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,wFAAwF;IACxF,IAAI,IAAI,UAAU,CAAC;IACnB,oDAAoD;IACpD,OAAO,IAAI,MAAM,CAAC;IAClB,oGAAoG;IACpG,YAAY,IAAI,MAAM,CAAC;IACvB,kGAAkG;IAClG,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,kDAAkD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,2DAA2D;AAC3D,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAyHD,qBAAa,OAAO;IA2BE,OAAO,CAAC,MAAM;IA1BlC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,yEAAyE;IACzE,OAAO,CAAC,aAAa,CAAqC;IAC1D,0EAA0E;IAC1E,OAAO,CAAC,4BAA4B,CAA6B;IACjE,OAAO,CAAC,wBAAwB,CAAC,CAAgB;IACjD,OAAO,CAAC,4BAA4B,CAAyB;IAC7D,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,KAAK,CAAC,CAAO;IACrB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,gFAAgF;IAChF,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD,OAAO,CAAC,YAAY,CAA+C;IACnE,wEAAwE;IACxE,OAAO,CAAC,UAAU,CAAsB;IAExC,yGAAyG;IACzG,OAAO,CAAC,QAAQ,CAA6F;IAE7G,OAAO;IAKP;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAInC;;;OAGG;IACH,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7C,2GAA2G;IAC3G,OAAO,CAAC,iBAAiB,CAAuC;IAEhE,OAAO,CAAC,qBAAqB,CAAsD;IAEnF,OAAO,CAAC,+BAA+B,CACgD;WAE1E,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA6IlE;;OAEG;YACW,QAAQ;IAgCtB;;OAEG;IACH,aAAa,IAAI,OAAO;IAMxB;;;OAGG;IACH,IAAI,OAAO,IAAI,kBAAkB,CAWhC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,UAAU,CAWrB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,mBAAmB,CAQjC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK,IAAI,KAAK,CAKjB;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,IAAI,CAKf;IAED;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAInF;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC9E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC;;;OAGG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;KAAE,GACvD,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7E;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;KAAE,GAClE,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;OAIG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;;;;;OAUG;IACG,cAAc,CAClB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GACxE,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkFrD;;;;OAIG;YACW,cAAc;IAsB5B,6EAA6E;YAC/D,cAAc;IAW5B;;;;;;;;;OASG;IACG,gBAAgB,CACpB,KAAK,GAAE,OAAO,CAAC,SAAS,EAAE,MAAM,CAAU,EAC1C,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;IA2EV,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAC1F,IAAI,CAAC,CAAC,EACJ,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC;IAKP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC3B;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhC;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EACxC,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,CAAC;IA6Db;;;;;;;;;;;;;OAaG;IACG,aAAa,CACjB,OAAO,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM,GAClD,OAAO,CAAC;QAAE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IA6BvC;;;OAGG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,EACxD,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,EACzD,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IAS/B;;;;;;;;;;;;;;;;;OAiBG;IACH,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAC7E,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IAiB/E;;;;;;;;OAQG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAClC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,QAAQ,CAAC;IAoCpB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,IAAI;IAYvE;;;;OAIG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IASpC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAMzC;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3D,OAAO,CAAC,YAAY;IAgBpB;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAmC/E;;OAEG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAkC3D;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IA2B9B;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/E;;;;;;;;OAQG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;IA4DhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IA2Bd,UAAU,CAAC,IAAI,CAAC,EAAE;QACtB,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C;;;;;WAKG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB;;;;;WAKG;QACH,WAAW,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1E,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB3B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgB3C;;;;OAIG;IACH,IAAI,cAAc,IAAI,cAAc,CAUnC;YAEa,8BAA8B;IAO5C;;;;;;;;;OASG;YACW,6BAA6B;YAqD7B,4BAA4B;IAiB1C,OAAO,CAAC,4BAA4B;IAOpC;;;;;;;;;;;;;;;;;;OAkBG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxE,IAAI,CACR,QAAQ,EAAE,MAAM,GAAG,EAAE,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;IAYV,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAS7E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ5G,OAAO;2CAKF;YACD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB;0DAQE;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB;MAGD;IAEF;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsCnB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE;IAK5B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,aAAa;IAK1C;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO;IAKvC;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAM9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa;IAI1G,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa;IAIlE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa;IAInE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa;IAIzE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAKtC,QAAQ,EAAE,QAAQ,CAAC;IAGnB,KAAK,EAAE,KAAK,CAAC;IAEb,MAAM,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAO;IAEX,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjF,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF;;;;;;;;;OASG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,GAAG,EAAE,EACrB,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAChF,OAAO,CAAC,IAAI,CAAC;IAShB,OAAO;IAKD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/lib/browser.js

@@ -1,6 +1,7 @@
 import { Builder } from './builder.js';
 import { ChromeService } from './chrome.js';
 import { FirefoxService } from './firefox.js';
+import { resolveBrowserBinaryPath } from './driverManager.js';
 import { By } from './by.js';
 import { until } from './wait.js';
 import { DEFAULT_ELEMENT_TIMEOUT_MS, DEFAULT_NAVIGATION_TIMEOUT_MS, STATE_POLL_INTERVAL_MS, NETWORK_IDLE_SETTLE_MS, PORT_RELEASE_DELAY_MS, BIDI_CONNECT_MAX_ATTEMPTS, BIDI_CONNECT_BACKOFF_STEP_MS, EVAL_REALM_RETRY_ATTEMPTS, EVAL_REALM_RETRY_DELAY_MS, } from './timing.js';
@@ -231,6 +232,12 @@ export class Browser {
         // Set up downloads directory
         const downloadsDir = options.downloadsDir ?? path.join(os.tmpdir(), 'craftdriver-downloads', `session-${Date.now()}-${Math.random().toString(36).slice(2)}`);
         await fs.mkdir(downloadsDir, { recursive: true });
+        // Custom browser binary (Chrome/Chromium/Firefox). When unresolved,
+        // nothing is forwarded and the driver uses its own built-in browser
+        // discovery — but see resolveBrowserBinaryPath's doc: some of the env
+        // vars in this chain aren't craftdriver-opt-in, they're ambient
+        // conventions other tools may already have set.
+        const browserPath = resolveBrowserBinaryPath(isChromeFamily ? 'chrome' : 'firefox', options.browserPath);
         let caps = {};
         if (isChromeFamily) {
             const chromeOptions = {
@@ -241,6 +248,8 @@ export class Browser {
                     'safebrowsing.enabled': true,
                 },
             };
+            if (browserPath)
+                chromeOptions.binary = browserPath;
             // Add mobile emulation if specified
             if (options.mobileEmulation) {
                 const emulation = typeof options.mobileEmulation === 'string'
@@ -285,6 +294,7 @@ export class Browser {
                     'browser.helperApps.neverAsk.saveToDisk': 'application/octet-stream,application/pdf,text/plain,text/csv,application/zip',
                     'pdfjs.disabled': true,
                 },
+                ...(browserPath ? { binary: browserPath } : {}),
             };
         }
         if (options.enableBiDi !== false) {
@@ -301,7 +311,10 @@ export class Browser {
         const builder = new Builder().forBrowser(name);
         let driverService;
         if (isChromeFamily) {
-            driverService = options.chromeService ?? new ChromeService();
+            // Only thread browserPath into a default ChromeService — a
+            // caller-supplied one is expected to already pin what it needs (same
+            // reasoning as explicit config always winning over auto-detection).
+            driverService = options.chromeService ?? new ChromeService({ browserPath });
             builder.setChromeService(driverService);
         }
         else {