@harnessed-ts/puppeteer 0.0.0-stage → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,79 @@
+# @harnessed-ts/puppeteer
+
+## 0.7.0
+
+### Patch Changes
+
+- Updated dependencies [ec06bdf]
+  - @harnessed-ts/core@0.7.0
+  - @harnessed-ts/resolve@0.7.0
+
+## 0.6.0
+
+### Minor Changes
+
+- e324e94: ember-test-selectors style test ids: `configure({ testIdAttribute: 'data-test-*' })` makes `testId('x')` match any element that has the attribute `data-test-x`, whatever its value, with the same scoping, strictness, `{ global: true }`, frame and absence rules as before under every driver. A plain attribute name keeps matching by value. A presence id is held to letters, digits, `-`, `_`, `.` and `:`, and anything else (or a `RegExp`) is refused rather than spliced into a selector.
+
+  `Query.boundingBox()` resolves to `{ x, y, width, height }`: the target's border box in CSS pixels, relative to the top-level viewport, offset by every frame crossed. Strict, and on an absent target it rejects after the timeout, as `text()` does. A node that draws no box reads as all zeros, and so does every node under the dom driver: jsdom computes no layout.
+
+  `Query.upload(files)` sets the files of an `<input type="file">`, or of the input a `<label>` is for, and fires `input` and `change`, replacing any earlier selection. It refuses any other element, and several files for an input that is not `multiple`. Puppeteer, WebdriverIO and TestCafe take only paths, so there each `File` is written to a temporary directory first: its name and bytes arrive, and the browser infers its type from the extension.
+
+  `Query` gains two abstract members, so a driver outside this repo implements both to keep compiling; the conformance catalog pins all three changes.
+
+  `@harnessed-ts/eslint-plugin` supports ESLint 8.57 and legacy `.eslintrc`: the peer range is now `>=8.57`, `legacy-recommended` and `legacy-strict` name the rules under `@harnessed-ts/`, and the CJS build exposes `rules` and `configs` at the top level, where eslintrc reads them.
+
+  `npx @harnessed-ts/claude install` detects ember-test-selectors attributes (in `.gts`, `.gjs` and `.hbs` files too) and writes `testIdAttribute: 'data-test-*'`.
+
+  `@harnessed-ts/storybook` writes and finds its story-ready marker under a `data-test-*` config, where `StoryPage` waits for it.
+
+### Patch Changes
+
+- Updated dependencies [e324e94]
+  - @harnessed-ts/core@0.6.0
+  - @harnessed-ts/resolve@0.6.0
+
+## 0.5.0
+
+### Patch Changes
+
+- @harnessed-ts/core@0.5.0
+  - @harnessed-ts/resolve@0.5.0
+
+## 0.4.0
+
+### Minor Changes
+
+- 9666a3d: New `@harnessed-ts/puppeteer` driver: `puppeteer(page, { baseURL })` builds the env, selectors resolve through the injected `@harnessed-ts/resolve`, actions go through Puppeteer's `ElementHandle`s, and `frame()` links are entered with `contentFrame()` — cross-origin frames included. It can navigate, and `@harnessed-ts/puppeteer/matchers` registers the matchers with Vitest.
+- 1823546: `isVisible()`, `waitFor('visible')` and `waitFor('hidden')` on a target matching
+  several nodes now reject with the shared strict-mode violation, at once, under
+  every driver. The dom, Ember, Vitest browser mode and Cypress drivers answered
+  `false` from `isVisible()`, waited out the timeout in `waitFor('visible')`, and —
+  worse — resolved `waitFor('hidden')` at once, passing a wait for three rendered
+  nodes to disappear; Playwright's waits raised its own wording instead of the
+  shared one. An `nth()`
+  past the last match answers `false` from `isVisible()` and counts as hidden, as it
+  does under Playwright — Puppeteer and TestCafe used to reject it as an index out
+  of range.
+
+  Core exports `StrictModeViolation`, the class `strictViolation()` now returns, so a
+  driver can tell ambiguity apart from absence. It is the class a caller catches
+  under every driver: core also exports `reviveStrictViolation()`, which the
+  Puppeteer, WebdriverIO and TestCafe drivers apply to what the page throws, so
+  a violation raised in the page arrives as core's class, worded exactly as an
+  in-process driver words it. `instanceof StrictModeViolation` checks a brand
+  rather than the prototype, so it holds across two copies of core in one page —
+  Cypress bundles the support file and each spec separately.
+
+  `WaitState` now documents the rule it is held to: a state joins only when every
+  driver honours it with the same meaning, so a runner's own states — Playwright's
+  `attached` and `detached` — stay out of the shared interface.
+
+### Patch Changes
+
+- Updated dependencies [9666a3d]
+- Updated dependencies [9666a3d]
+- Updated dependencies [9666a3d]
+- Updated dependencies [9666a3d]
+- Updated dependencies [1823546]
+  - @harnessed-ts/core@0.4.0
+  - @harnessed-ts/resolve@0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joe Gaudet, Jay Seo
+
+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/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @harnessed-ts/puppeteer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Puppeteer driver for `@harnessed-ts/core`. It injects the shared resolver into
+the page, so selectors resolve exactly as they do under the other drivers, and
+acts through `ElementHandle`s, so input is real browser input. Frames are entered
+with `contentFrame()`, cross-origin ones included.
+
+```ts
+import { puppeteer } from '@harnessed-ts/puppeteer'
+import '@harnessed-ts/puppeteer/matchers' // Vitest; under Jest, expect.extend(harnessMatchers)
+
+const page = await browser.newPage()
+const login = new LoginPage(puppeteer(page, { baseURL: 'http://localhost:3000' }))
+await login.goto()
+```
+
+`baseURL` is what a page's relative `path` resolves against in `goto()`.
+
+Full guide, the cross-driver guarantees, and the API: the
+[harnessed README](https://github.com/joegaudet/harnessed#readme).
+
+MIT © Joe Gaudet, Jay Seo

package/dist/driver-id.d.ts

@@ -0,0 +1,3 @@
+/** Its own module so `env.ts` and `puppeteer-query.ts` can share it without a cycle. */
+export declare const PUPPETEER_DRIVER = "puppeteer";
+//# sourceMappingURL=driver-id.d.ts.map

package/dist/driver-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-id.d.ts","sourceRoot":"","sources":["../src/driver-id.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,cAAc,CAAA"}

package/dist/env.d.ts

@@ -0,0 +1,21 @@
+import type { EnvConfig } from '@harnessed-ts/core';
+import type { Page } from 'puppeteer';
+import { PUPPETEER_DRIVER } from './driver-id';
+import './puppeteer-query';
+export { PUPPETEER_DRIVER };
+export interface PuppeteerEnv extends EnvConfig {
+    readonly driver: typeof PUPPETEER_DRIVER;
+    readonly page: Page;
+    /**
+     * What a page's relative `path` resolves against in `goto()`. Puppeteer has no
+     * `baseURL` of its own, unlike Playwright's config. Without one, a relative
+     * path resolves against the page's current URL.
+     */
+    readonly baseURL: string | undefined;
+}
+export interface PuppeteerEnvOptions {
+    baseURL?: string;
+}
+/** Builds the env a harness is constructed with under Puppeteer. */
+export declare function puppeteer(page: Page, options?: PuppeteerEnvOptions): PuppeteerEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,mBAAmB,CAAA;AAE1B,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAE3B,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,QAAQ,CAAC,MAAM,EAAE,OAAO,gBAAgB,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAErF"}