fluxwright 0.1.0 → 0.2.0

package/LICENSE-MIT

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Fluxwright contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Fluxwright contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MISSING.md

@@ -1,16 +1,15 @@
-# Playwright methods not in Fluxwright (TypeScript)
-
-The TS binding covers the same small page API as the Rust crate. Missing on purpose:
-
-- Firefox / WebKit
-- Tracing, HAR, video
-- `page.route` beyond resource-type / URL blocking on the job
-- Network idle waits as first-class APIs
-- Storage state import/export
-- `page.emulateMedia`, geolocation, permissions helpers
-- Playwright Test runner, fixtures, expect
-- `locator.filter`, `getByRole`, `getByText` (basic CSS locator only)
-- Multiple pages per context
-- Download / upload helpers
-- WebSocket / worker APIs
-- `connectOverCDP` (planned as a later `BrowserSource`)
+# Playwright methods not in Fluxwright (TypeScript)
+
+The TS binding covers the same small page API as the Rust crate. Missing on purpose:
+
+- Firefox / WebKit
+- Tracing, HAR, video
+- `page.route` beyond resource-type / URL blocking on the job
+- Storage state import/export
+- `page.emulateMedia`, geolocation, permissions helpers
+- Playwright Test runner, fixtures, expect
+- `locator.filter`, `nth`, `getByLabel`/`getByPlaceholder`/`getByTestId`, shadow-DOM piercing
+- Multiple pages per context
+- Download / upload helpers
+- WebSocket / worker APIs
+- `connectOverCDP` (planned as a later `BrowserSource`)

package/README.md

@@ -1,56 +1,59 @@
-# fluxwright
-
-In-process **Chromium fleet** for Node. Lease API (fresh context per `newPage`), not Playwright parity.
-
-Requires a local Chrome/Chromium binary (`FLUXWRIGHT_CHROMIUM`, `CHROME`, `CHROMIUM`, or a standard install path).
-
-## Install
-
-```bash
-npm install fluxwright
-```
-
-If no prebuild exists for your platform, you need Rust + Chrome, then from this package directory:
-
-```bash
-npm run build
-```
-
-## Use
-
-```ts
-import { chromium } from "fluxwright";
-
-const browser = await chromium.launch({ maxBrowsers: 4 });
-const page = await browser.newPage();
-await page.goto("https://example.com");
-console.log(await page.title());
-await page.click("css-selector");
-await page.fill("input", "value");
-const html = await page.content();
-const png = await page.screenshot(); // Buffer
-await page.close();
-await browser.close();
-```
-
-`chromium.launch` starts the Fluxwright engine in-process. Each `newPage` is a **new browser context**. Drop/`close` destroys that context and returns the slot.
-
-### API
-
-| Method | What it does |
-|---|---|
-| `chromium.launch({ maxBrowsers? })` | Start the pool |
-| `browser.newPage()` | Acquire a lease |
-| `page.goto(url)` | Navigate |
-| `page.title()` / `page.content()` | Read |
-| `page.click(selector)` / `page.fill(selector, value)` | CSS only |
-| `page.evaluate(expression)` | `Runtime.evaluate`, JSON |
-| `page.screenshot()` | PNG `Buffer` |
-| `page.waitForSelector(selector)` | Actionable wait |
-| `page.close()` / `browser.close()` | Dispose context / shut down |
-
-See `MISSING.md` for Playwright methods that will not be added.
-
-## License
-
-MIT OR Apache-2.0
+# fluxwright
+
+In-process **Chromium fleet** for Node. Lease API (fresh context per `newPage`), not Playwright parity.
+
+Requires a local Chrome/Chromium binary (`FLUXWRIGHT_CHROMIUM`, `CHROME`, `CHROMIUM`, or a standard install path).
+
+## Install
+
+```bash
+npm install fluxwright
+```
+
+If no prebuild exists for your platform, you need Rust + Chrome, then from this package directory:
+
+```bash
+npm run build
+```
+
+## Use
+
+```ts
+import { chromium } from "fluxwright";
+
+const browser = await chromium.launch({ maxBrowsers: 4 });
+const page = await browser.newPage();
+await page.goto("https://example.com");
+console.log(await page.title());
+await page.click("css-selector");
+await page.fill("input", "value");
+const html = await page.content();
+const png = await page.screenshot(); // Buffer
+await page.close();
+await browser.close();
+```
+
+`chromium.launch` starts the Fluxwright engine in-process. Each `newPage` is a **new browser context**. Drop/`close` destroys that context and returns the slot.
+
+### API
+
+| Method | What it does |
+|---|---|
+| `chromium.launch({ maxBrowsers?, executablePath?, headless? })` | Start the pool. Headless uses chrome-headless-shell when installed (as Playwright does), else Chrome; `FLUXWRIGHT_CHROMIUM` or `executablePath` overrides |
+| `browser.newPage({ proxy? })` | Acquire a lease (a fresh context). `proxy: { server, bypass?, username?, password? }` applies to this page only |
+| `page.goto(url, { waitUntil? })` | Navigate. `waitUntil`: `load` (default), `domcontentloaded`, `networkidle`, `commit`. Event-driven, like Playwright |
+| `page.title()` / `page.content()` | Read |
+| `page.click(selector)` / `page.fill(selector, value)` | Scrolls into view, waits until enabled, stable, and not covered. Selector: CSS, `text=Foo`, `text="Exact"`, `role=button[name="Save"]` |
+| `page.getByRole(role, { name?, exact? })` / `page.getByText(text, { exact? })` / `page.locator(selector)` | `Locator` with `click()`, `fill(v)`, `waitFor()`, `textContent()`. Implicit ARIA roles and accessible names; hidden elements never match a role |
+| `page.frameLocator(iframeSelector)` | Same locators inside an iframe, same- or cross-origin; nest with `.frameLocator()` |
+| `page.evaluate(expression)` | `Runtime.evaluate`, JSON. A thrown JS error rejects with its message and stack |
+| `page.screenshot({ fullPage? })` | PNG `Buffer` |
+| `page.setViewportSize({ width, height })` | CSS-pixel viewport for this page |
+| `page.waitForSelector(selector)` | Waits until visible (Playwright's default state) |
+| `page.close()` / `browser.close()` | Dispose context / shut down |
+
+See `MISSING.md` for Playwright methods that will not be added.
+
+## License
+
+MIT OR Apache-2.0

package/addon.d.ts

@@ -1,5 +1,5 @@
-export * from './index'
-import { Chromium } from './index'
-/** Playwright-style export: `chromium.launch(...)`. Same as `Chromium.launch`. */
-export const chromium: typeof Chromium
-export default { chromium }
+export * from './index'
+import { Chromium } from './index'
+/** Playwright-style export: `chromium.launch(...)`. Same as `Chromium.launch`. */
+export const chromium: typeof Chromium
+export default { chromium }

package/addon.js

@@ -1,17 +1,17 @@
-'use strict'
-
-try {
-  const native = require('./index.js')
-  module.exports = native
-  module.exports.chromium = native.Chromium
-  module.exports.default = module.exports
-} catch (err) {
-  module.exports = {
-    chromium: {
-      launch: async () => {
-        throw new Error('build the native addon: npm run build')
-      },
-    },
-  }
-  module.exports.default = module.exports
-}
+'use strict'
+
+try {
+  const native = require('./index.js')
+  module.exports = native
+  module.exports.chromium = native.Chromium
+  module.exports.default = module.exports
+} catch (err) {
+  module.exports = {
+    chromium: {
+      launch: async () => {
+        throw new Error('build the native addon: npm run build')
+      },
+    },
+  }
+  module.exports.default = module.exports
+}

package/index.d.ts

@@ -1,27 +1,85 @@
-/* tslint:disable */
-/* eslint-disable */
-
-/* auto-generated by NAPI-RS */
-
-export interface LaunchOptions {
-  maxBrowsers?: number
-}
-export declare function chromium(): Chromium
-export declare class Browser {
-  newPage(): Promise<Page>
-  close(): Promise<void>
-}
-export declare class Page {
-  goto(url: string): Promise<void>
-  title(): Promise<string>
-  content(): Promise<string>
-  click(selector: string): Promise<void>
-  fill(selector: string, value: string): Promise<void>
-  evaluate(expression: string): Promise<any>
-  screenshot(): Promise<Buffer>
-  waitForSelector(selector: string): Promise<void>
-  close(): Promise<void>
-}
-export declare class Chromium {
-  static launch(options?: LaunchOptions | undefined | null): Promise<Browser>
-}
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface GetByTextOptions {
+  /** Default false: case-insensitive substring. */
+  exact?: boolean
+}
+export interface GetByRoleOptions {
+  /** Accessible name. Default: case-insensitive substring. */
+  name?: string
+  exact?: boolean
+}
+export interface LaunchOptions {
+  maxBrowsers?: number
+  /** Browser binary. Default: chrome-headless-shell when headless and installed, else Chrome. */
+  executablePath?: string
+  /** Default true. */
+  headless?: boolean
+}
+export interface ProxyOptions {
+  /** `http://host:port`, `socks5://host:port`, ... */
+  server: string
+  /** Comma-separated hosts that skip the proxy. */
+  bypass?: string
+  username?: string
+  password?: string
+}
+export interface NewPageOptions {
+  proxy?: ProxyOptions
+}
+export interface GotoOptions {
+  /** Default "load". */
+  waitUntil?: 'load' | 'domcontentloaded' | 'networkidle' | 'commit'
+}
+export interface ScreenshotOptions {
+  fullPage?: boolean
+}
+export interface ViewportSize {
+  width: number
+  height: number
+}
+export declare function chromium(): Chromium
+export declare class Browser {
+  /** A fresh browser context. `proxy` applies to this page only. */
+  newPage(options?: NewPageOptions | undefined | null): Promise<Page>
+  close(): Promise<void>
+}
+export declare class Page {
+  goto(url: string, options?: GotoOptions | undefined | null): Promise<void>
+  title(): Promise<string>
+  content(): Promise<string>
+  click(selector: string): Promise<void>
+  fill(selector: string, value: string): Promise<void>
+  evaluate(expression: string): Promise<any>
+  screenshot(options?: ScreenshotOptions | undefined | null): Promise<Buffer>
+  setViewportSize(size: ViewportSize): Promise<void>
+  waitForSelector(selector: string): Promise<void>
+  /** CSS, `text=`, or `role=` selector. */
+  locator(selector: string): Locator
+  getByText(text: string, options?: GetByTextOptions | undefined | null): Locator
+  getByRole(role: string, options?: GetByRoleOptions | undefined | null): Locator
+  frameLocator(selector: string): FrameLocator
+  close(): Promise<void>
+}
+/** Lazy, like Playwright's: every action runs the query again. */
+export declare class Locator {
+  click(): Promise<void>
+  fill(value: string): Promise<void>
+  /** Waits until visible. */
+  waitFor(): Promise<void>
+  textContent(): Promise<string | null>
+}
+/** An iframe, same- or cross-origin, to find elements in. */
+export declare class FrameLocator {
+  locator(selector: string): Locator
+  getByText(text: string, options?: GetByTextOptions | undefined | null): Locator
+  getByRole(role: string, options?: GetByRoleOptions | undefined | null): Locator
+  /** A nested iframe inside this one. */
+  frameLocator(selector: string): FrameLocator
+}
+export declare class Chromium {
+  static launch(options?: LaunchOptions | undefined | null): Promise<Browser>
+}

package/index.js

@@ -1,318 +1,320 @@
-/* tslint:disable */
-/* eslint-disable */
-/* prettier-ignore */
-
-/* auto-generated by NAPI-RS */
-
-const { existsSync, readFileSync } = require('fs')
-const { join } = require('path')
-
-const { platform, arch } = process
-
-let nativeBinding = null
-let localFileExisted = false
-let loadError = null
-
-function isMusl() {
-  // For Node 10
-  if (!process.report || typeof process.report.getReport !== 'function') {
-    try {
-      const lddPath = require('child_process').execSync('which ldd').toString().trim()
-      return readFileSync(lddPath, 'utf8').includes('musl')
-    } catch (e) {
-      return true
-    }
-  } else {
-    const { glibcVersionRuntime } = process.report.getReport().header
-    return !glibcVersionRuntime
-  }
-}
-
-switch (platform) {
-  case 'android':
-    switch (arch) {
-      case 'arm64':
-        localFileExisted = existsSync(join(__dirname, 'fluxwright.android-arm64.node'))
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.android-arm64.node')
-          } else {
-            nativeBinding = require('fluxwright-android-arm64')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'arm':
-        localFileExisted = existsSync(join(__dirname, 'fluxwright.android-arm-eabi.node'))
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.android-arm-eabi.node')
-          } else {
-            nativeBinding = require('fluxwright-android-arm-eabi')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Android ${arch}`)
-    }
-    break
-  case 'win32':
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(
-          join(__dirname, 'fluxwright.win32-x64-msvc.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.win32-x64-msvc.node')
-          } else {
-            nativeBinding = require('fluxwright-win32-x64-msvc')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'ia32':
-        localFileExisted = existsSync(
-          join(__dirname, 'fluxwright.win32-ia32-msvc.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.win32-ia32-msvc.node')
-          } else {
-            nativeBinding = require('fluxwright-win32-ia32-msvc')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'fluxwright.win32-arm64-msvc.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.win32-arm64-msvc.node')
-          } else {
-            nativeBinding = require('fluxwright-win32-arm64-msvc')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Windows: ${arch}`)
-    }
-    break
-  case 'darwin':
-    localFileExisted = existsSync(join(__dirname, 'fluxwright.darwin-universal.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./fluxwright.darwin-universal.node')
-      } else {
-        nativeBinding = require('fluxwright-darwin-universal')
-      }
-      break
-    } catch {}
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'fluxwright.darwin-x64.node'))
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.darwin-x64.node')
-          } else {
-            nativeBinding = require('fluxwright-darwin-x64')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'fluxwright.darwin-arm64.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.darwin-arm64.node')
-          } else {
-            nativeBinding = require('fluxwright-darwin-arm64')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}`)
-    }
-    break
-  case 'freebsd':
-    if (arch !== 'x64') {
-      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
-    }
-    localFileExisted = existsSync(join(__dirname, 'fluxwright.freebsd-x64.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./fluxwright.freebsd-x64.node')
-      } else {
-        nativeBinding = require('fluxwright-freebsd-x64')
-      }
-    } catch (e) {
-      loadError = e
-    }
-    break
-  case 'linux':
-    switch (arch) {
-      case 'x64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-x64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-x64-musl.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-x64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-x64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-x64-gnu.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-x64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 'arm64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-arm64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-arm64-musl.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-arm64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-arm64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-arm64-gnu.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-arm64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 'arm':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-arm-musleabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-arm-musleabihf.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-arm-musleabihf')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-arm-gnueabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-arm-gnueabihf.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-arm-gnueabihf')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 'riscv64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-riscv64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-riscv64-musl.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-riscv64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'fluxwright.linux-riscv64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./fluxwright.linux-riscv64-gnu.node')
-            } else {
-              nativeBinding = require('fluxwright-linux-riscv64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 's390x':
-        localFileExisted = existsSync(
-          join(__dirname, 'fluxwright.linux-s390x-gnu.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./fluxwright.linux-s390x-gnu.node')
-          } else {
-            nativeBinding = require('fluxwright-linux-s390x-gnu')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Linux: ${arch}`)
-    }
-    break
-  default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
-}
-
-if (!nativeBinding) {
-  if (loadError) {
-    throw loadError
-  }
-  throw new Error(`Failed to load native binding`)
-}
-
-const { Browser, Page, Chromium, chromium } = nativeBinding
-
-module.exports.Browser = Browser
-module.exports.Page = Page
-module.exports.Chromium = Chromium
-module.exports.chromium = chromium
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'fluxwright.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.android-arm64.node')
+          } else {
+            nativeBinding = require('fluxwright-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'fluxwright.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('fluxwright-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('fluxwright-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('fluxwright-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('fluxwright-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'fluxwright.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./fluxwright.darwin-universal.node')
+      } else {
+        nativeBinding = require('fluxwright-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'fluxwright.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.darwin-x64.node')
+          } else {
+            nativeBinding = require('fluxwright-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.darwin-arm64.node')
+          } else {
+            nativeBinding = require('fluxwright-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'fluxwright.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./fluxwright.freebsd-x64.node')
+      } else {
+        nativeBinding = require('fluxwright-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('fluxwright-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { Browser, Page, Locator, FrameLocator, Chromium, chromium } = nativeBinding
+
+module.exports.Browser = Browser
+module.exports.Page = Page
+module.exports.Locator = Locator
+module.exports.FrameLocator = FrameLocator
+module.exports.Chromium = Chromium
+module.exports.chromium = chromium

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "fluxwright",
-  "version": "0.1.0",
-  "description": "In-process Chromium fleet engine (napi-rs). Lease API, not Playwright parity.",
-  "main": "addon.js",
-  "types": "addon.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/harshit-d3v/fluxwright.git",
-    "directory": "bindings/node"
-  },
-  "homepage": "https://github.com/harshit-d3v/fluxwright#readme",
-  "bugs": {
-    "url": "https://github.com/harshit-d3v/fluxwright/issues"
-  },
-  "keywords": [
-    "chromium",
-    "chrome",
-    "cdp",
-    "browser-pool",
-    "automation",
-    "napi-rs"
-  ],
-  "author": "Fluxwright contributors",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "addon.js",
-    "addon.d.ts",
-    "index.js",
-    "index.d.ts",
-    "MISSING.md",
-    "README.md",
-    "LICENSE-MIT"
-  ],
-  "scripts": {
-    "build": "napi build --platform --release",
-    "build:debug": "napi build --platform",
-    "artifacts": "napi artifacts",
-    "prepublishOnly": "napi prepublish -t npm --skip-gh-release"
-  },
-  "napi": {
-    "name": "fluxwright",
-    "triples": {
-      "defaults": true,
-      "additional": [
-        "aarch64-apple-darwin"
-      ]
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@napi-rs/cli": "^2.18.4"
-  },
-  "optionalDependencies": {
-    "fluxwright-win32-x64-msvc": "0.1.0",
-    "fluxwright-darwin-x64": "0.1.0",
-    "fluxwright-linux-x64-gnu": "0.1.0",
-    "fluxwright-darwin-arm64": "0.1.0"
-  }
-}
+{
+  "name": "fluxwright",
+  "version": "0.2.0",
+  "description": "In-process Chromium fleet engine (napi-rs). Lease API, not Playwright parity.",
+  "main": "addon.js",
+  "types": "addon.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harshit-d3v/fluxwright.git",
+    "directory": "bindings/node"
+  },
+  "homepage": "https://github.com/harshit-d3v/fluxwright#readme",
+  "bugs": {
+    "url": "https://github.com/harshit-d3v/fluxwright/issues"
+  },
+  "keywords": [
+    "chromium",
+    "chrome",
+    "cdp",
+    "browser-pool",
+    "automation",
+    "napi-rs"
+  ],
+  "author": "Fluxwright contributors",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "addon.js",
+    "addon.d.ts",
+    "index.js",
+    "index.d.ts",
+    "MISSING.md",
+    "README.md",
+    "LICENSE-MIT"
+  ],
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "artifacts": "napi artifacts",
+    "prepublishOnly": "napi prepublish -t npm --skip-gh-release"
+  },
+  "napi": {
+    "name": "fluxwright",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin"
+      ]
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4"
+  },
+  "optionalDependencies": {
+    "fluxwright-darwin-arm64": "0.2.0",
+    "fluxwright-darwin-x64": "0.2.0",
+    "fluxwright-linux-x64-gnu": "0.2.0",
+    "fluxwright-win32-x64-msvc": "0.2.0"
+  }
+}