@toolstackhq/cdpwright 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# cdpwright
+
+Chromium-only automation built on the Chrome DevTools Protocol (CDP). A lightweight, Playwright-style API with `Browser`, `Context`, `Page`, `Frame`, and `Locator` primitives—no test runner included.
+
+## Quick start
+
+```bash
+npm install @toolstackhq/cdpwright
+npx cpw download    # downloads a pinned Chromium build
+```
+
+```ts
+// quick.js
+import { chromium, expect } from "@toolstackhq/cdpwright";
+
+const browser = await chromium.launch({ headless: true });
+const page = await browser.newPage();
+
+await page.goto("https://example.com");
+await expect(page).element("h1").toHaveText(/Example Domain/);
+
+await browser.close();
+```
+
+Run it:
+```bash
+node quick.js
+```
+
+## Core ideas
+- CDP-only: no WebDriver, no playwright-core dependency.
+- Small surface: pages/frames/locators, plus built-in expect matchers.
+- Selector routing: CSS by default; XPath if the selector starts with `/`, `./`, `.//`, `..`, or `(/`. Shadow DOM via `>>>` (e.g., `host >>> button`).
+- Contexts: `browser.newContext()` gives incognito-style isolation without launching a new browser.
+- Downloads: `npx cpw download` (or `--latest`) fetches Chromium into a local cache.
+
+## Key APIs
+- `chromium.launch(options)` → `Browser`
+- `browser.newContext()` → isolated `BrowserContext`
+- `browser.newPage()` / `context.newPage()` → `Page`
+- `page.goto(url, { waitUntil: "load" | "domcontentloaded" })`
+- Actions: `click`, `dblclick`, `type`, `typeSecure`, `fillInput`, `selectOption`, `setFileInput`
+- Queries: `query`, `queryAll`, `queryXPath`, `queryAllXPath`, `locator`
+- Assertions: `expect(page).element("selector").toBeVisible()` (see `docs/guide/assertions.md`)
+
+## Architecture at a glance (render-friendly)
+```
+CLI (cpw download) -> Downloader -> Chromium cache
+
+User code -> chromium.launch -> ChromiumManager -> Chromium process
+Chromium process -> CDP connection -> Browser -> Page -> Frame
+Page -> Locator / expect
+```
+
+## Docs
+Full guide and API reference: https://toolstackhq.github.io/cdpwright/ (built from `docs/` via VitePress). Start at `docs/guide/intro.md` or `docs/guide/api/`.
+
+## Demo app
+`index.html` is a local, data-driven visa-style wizard used to stress-test automation flows (no server required). Open it directly via `file://` to exercise navigation, conditionals, overlays, Shadow DOM, uploads, and receipts.
+
+## License
+MIT

package/dist/assert/expect.d.ts

@@ -0,0 +1 @@
+export { E as ElementExpectation, c as ExpectFrame, d as ExpectSelectorOptions, e as expect } from '../expect-CY70zJc0.js';

package/dist/assert/expect.js

@@ -0,0 +1,7 @@
+import {
+  expect
+} from "../chunk-6BPF3IEU.js";
+export {
+  expect
+};
+//# sourceMappingURL=expect.js.map

package/dist/assert/expect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}