touchpress 0.0.1 → 0.0.2

package/README.md

@@ -1,12 +1,12 @@
-# tangere
+# touchpress
 
 > [!WARNING]
-> tangere is highly experimental. Use at your own risk.
+> touchpress is highly experimental. Use at your own risk.
 
-tangere runs e2e tests for mobile apps on the Playwright test runner. It drives a booted simulator or emulator through [`agent-device`](https://agent-device.dev/).
+touchpress runs e2e tests for mobile apps on the Playwright test runner. It drives a booted simulator or emulator through [`agent-device`](https://agent-device.dev/).
 
 ```ts
-import { expect, test } from 'tangere';
+import { expect, test } from 'touchpress';
 
 test('the right credentials land on the profile', async ({ device }) => {
   await device.getByTestId('sign-in-link').tap();
@@ -24,7 +24,7 @@ test('the right credentials land on the profile', async ({ device }) => {
 ### Install
 
 ```sh
-pnpm add -D tangere @playwright/test
+pnpm add -D touchpress @playwright/test
 ```
 
 ### Configure
@@ -32,9 +32,9 @@ pnpm add -D tangere @playwright/test
 ```ts
 // playwright.config.ts
 import { defineConfig } from '@playwright/test';
-import type { TangereOptions } from 'tangere';
+import type { TouchpressOptions } from 'touchpress';
 
-export default defineConfig<TangereOptions>({
+export default defineConfig<TouchpressOptions>({
   testDir: 'e2e',
   workers: 1,
   expect: { timeout: 10_000 },
@@ -50,9 +50,9 @@ export default defineConfig<TangereOptions>({
 });
 ```
 
-Every option tangere adds is a key of its own in `use`. Playwright merges `use` one key at a time, so what the projects share is written once at the top level and a project sets only what differs.
+Every option touchpress adds is a key of its own in `use`. Playwright merges `use` one key at a time, so what the projects share is written once at the top level and a project sets only what differs.
 
-`readyWhen` is required. The driver returns from a launch as soon as the native process starts, before the JavaScript bundle has loaded, so tangere waits for that locator before the first test runs.
+`readyWhen` is required. The driver returns from a launch as soon as the native process starts, before the JavaScript bundle has loaded, so touchpress waits for that locator before the first test runs.
 
 `deviceName` is what `agent-device devices` prints, which for an Android emulator is the AVD name with its underscores shown as spaces. An AVD created as `Pixel_7_API_34` is `Pixel 7 API 34` here.
 
@@ -64,11 +64,11 @@ One worker gets one device. To run more than one, give `deviceName` an array wit
 npx playwright test --project=ios
 ```
 
-`preflight` reads a project's options and reports whether the device they name is booted, so a missing simulator fails once, in about a second, instead of once per test after the launch timeout. Wire it as a setup project per platform that the device projects depend on. [Basics](https://github.com/wobsoriano/tangere/blob/main/docs/basics.md) has the spec, and [`apps/e2e/e2e/preflight.setup.mts`](https://github.com/wobsoriano/tangere/blob/main/apps/e2e/e2e/preflight.setup.mts) is a working one.
+`preflight` reads a project's options and reports whether the device they name is booted, so a missing simulator fails once, in about a second, instead of once per test after the launch timeout. Wire it as a setup project per platform that the device projects depend on. [Basics](https://github.com/wobsoriano/touchpress/blob/main/docs/basics.md) has the spec, and [`apps/e2e/e2e/preflight.setup.mts`](https://github.com/wobsoriano/touchpress/blob/main/apps/e2e/e2e/preflight.setup.mts) is a working one.
 
 ## Run the sample project
 
-`apps/e2e` is an Expo app with a home, login, and profile route and a fake sign-in. It is the app tangere is tested against. Build the library first with `vp run -r build` so the app can resolve `dist`, then run these from `apps/e2e`:
+`apps/e2e` is an Expo app with a home, login, and profile route and a fake sign-in. It is the app touchpress is tested against. Build the library first with `vp run -r build` so the app can resolve `dist`, then run these from `apps/e2e`:
 
 ```sh
 npx expo run:ios --device 'iPhone 17 Pro Max' --no-bundler
@@ -89,18 +89,18 @@ Leave Metro running for the whole suite. The first build takes several minutes.
 
 ## Docs
 
-- [Basics](https://github.com/wobsoriano/tangere/blob/main/docs/basics.md)
-- [Configuration](https://github.com/wobsoriano/tangere/blob/main/docs/configuration.md)
-- [Locators](https://github.com/wobsoriano/tangere/blob/main/docs/locators.md)
-- [Assertions](https://github.com/wobsoriano/tangere/blob/main/docs/assertions.md)
-- [Lifecycle](https://github.com/wobsoriano/tangere/blob/main/docs/lifecycle.md)
-- [Continuous integration](https://github.com/wobsoriano/tangere/blob/main/docs/ci.md)
+- [Basics](https://github.com/wobsoriano/touchpress/blob/main/docs/basics.md)
+- [Configuration](https://github.com/wobsoriano/touchpress/blob/main/docs/configuration.md)
+- [Locators](https://github.com/wobsoriano/touchpress/blob/main/docs/locators.md)
+- [Assertions](https://github.com/wobsoriano/touchpress/blob/main/docs/assertions.md)
+- [Lifecycle](https://github.com/wobsoriano/touchpress/blob/main/docs/lifecycle.md)
+- [Continuous integration](https://github.com/wobsoriano/touchpress/blob/main/docs/ci.md)
 
 ## The workspace
 
 ```
-packages/tangere/  the library, published to npm
-apps/e2e/          tangere-e2e, an Expo SDK 57 app, private
+packages/touchpress/  the library, published to npm
+apps/e2e/          touchpress-e2e, an Expo SDK 57 app, private
 docs/              the documentation linked above
 ```
 

package/dist/core/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as Tree, A as deviceNameForSlot, B as ProbeResult, C as openSession, D as ResolvedOptions, E as ReadyQuery, F as StepOptions, G as CaptureOptions, H as formatFailure, I as Typed, J as DeviceInfo, K as DeviceDriver, L as renderTitle, M as ActionRecord, N as ActionSink, O as TANGERE_DEFAULTS, P as EvidenceFile, Q as Settled, R as silentSink, S as SessionState, T as DeviceChoice, U as probe, V as ProbeTarget, W as Binding, X as OpenRequest, Y as DeviceSelection, Z as ScrollDirection, _ as RoleOptions, _t as Screen, a as ExpectedValue, at as Filter, b as DeviceSession, bt as renderScreen, c as ScrollSearch, ct as TextMatch, d as directionToward, dt as textMatch, et as Check, f as ActionOptions, ft as PinnedRef, g as Locator, gt as Resolution, h as FilterOptions, ht as Rect, i as ErrorInfo, it as evaluate, j as parseDeviceOptions, k as TangereOptions, l as ScrollTrail, lt as describeQuery, m as FillOptions, mt as RawSnapshot, n as PreflightReport, nt as Verdict, o as TangereError, ot as Query, p as Device, pt as Platform, q as DeviceFailure, r as preflight, rt as describeCheck, s as ScrollDevice, st as Role, t as PreflightDevice, tt as CheckName, u as createScrollSearch, ut as normalizeText, v as TextOptions, vt as ScreenNode, w as sessionName, x as OpenSessionInput, xt as resolve, y as createDevice, yt as parseScreen, z as ProbeOptions } from "../preflight--Z-REtl-.mjs";
+import { $ as Tree, A as deviceNameForSlot, B as ProbeResult, C as openSession, D as ResolvedOptions, E as ReadyQuery, F as StepOptions, G as CaptureOptions, H as formatFailure, I as Typed, J as DeviceInfo, K as DeviceDriver, L as renderTitle, M as ActionRecord, N as ActionSink, O as TOUCHPRESS_DEFAULTS, P as EvidenceFile, Q as Settled, R as silentSink, S as SessionState, T as DeviceChoice, U as probe, V as ProbeTarget, W as Binding, X as OpenRequest, Y as DeviceSelection, Z as ScrollDirection, _ as RoleOptions, _t as Screen, a as ExpectedValue, at as Filter, b as DeviceSession, bt as renderScreen, c as ScrollSearch, ct as TextMatch, d as directionToward, dt as textMatch, et as Check, f as ActionOptions, ft as PinnedRef, g as Locator, gt as Resolution, h as FilterOptions, ht as Rect, i as ErrorInfo, it as evaluate, j as parseDeviceOptions, k as TouchpressOptions, l as ScrollTrail, lt as describeQuery, m as FillOptions, mt as RawSnapshot, n as PreflightReport, nt as Verdict, o as TouchpressError, ot as Query, p as Device, pt as Platform, q as DeviceFailure, r as preflight, rt as describeCheck, s as ScrollDevice, st as Role, t as PreflightDevice, tt as CheckName, u as createScrollSearch, ut as normalizeText, v as TextOptions, vt as ScreenNode, w as sessionName, x as OpenSessionInput, xt as resolve, y as createDevice, yt as parseScreen, z as ProbeOptions } from "../preflight-CCKYplYi.mjs";
 //#region src/core/evidence.d.ts
 /**
  * Never throws. A capture that fails records a note and returns, because masking
@@ -68,4 +68,4 @@ declare function toPixelBox(rect: {
 /** Moves a box into the coordinates of a crop taken at `origin`. */
 declare function relativeTo(box: PixelBox, origin: PixelBox): PixelBox;
 //#endregion
-export { type ActionOptions, type ActionRecord, type ActionSink, type Binding, type CaptureOptions, type Check, type CheckName, type CompareOptions, type Comparison, type Device, type DeviceChoice, type DeviceDriver, type DeviceFailure, type DeviceInfo, type DeviceSelection, type DeviceSession, type ErrorInfo, type EvidenceFile, type ExpectedValue, type FillOptions, type Filter, type FilterOptions, type Locator, type OpenRequest, type OpenSessionInput, type PinnedRef, type PixelBox, type Platform, type PreflightDevice, type PreflightReport, type ProbeOptions, type ProbeResult, type ProbeTarget, type Query, type RawSnapshot, type ReadyQuery, type Rect, type Resolution, type ResolvedOptions, type Role, type RoleOptions, type Screen, type ScreenNode, type ScrollDevice, type ScrollDirection, type ScrollSearch, type ScrollTrail, type SessionState, type Settled, type Size, type StepOptions, TANGERE_DEFAULTS, TangereError, type TangereOptions, type TextMatch, type TextOptions, type Tree, type Typed, type Verdict, captureEvidence, compareScreenshot, createDevice, createScrollSearch, cropScreenshot, describeCheck, describeQuery, deviceNameForSlot, directionToward, evaluate, formatFailure, normalizeText, openSession, parseDeviceOptions, parseScreen, preflight, probe, relativeTo, renderScreen, renderTitle, resolve, sessionName, silentSink, sizeOf, textMatch, toPixelBox };
+export { type ActionOptions, type ActionRecord, type ActionSink, type Binding, type CaptureOptions, type Check, type CheckName, type CompareOptions, type Comparison, type Device, type DeviceChoice, type DeviceDriver, type DeviceFailure, type DeviceInfo, type DeviceSelection, type DeviceSession, type ErrorInfo, type EvidenceFile, type ExpectedValue, type FillOptions, type Filter, type FilterOptions, type Locator, type OpenRequest, type OpenSessionInput, type PinnedRef, type PixelBox, type Platform, type PreflightDevice, type PreflightReport, type ProbeOptions, type ProbeResult, type ProbeTarget, type Query, type RawSnapshot, type ReadyQuery, type Rect, type Resolution, type ResolvedOptions, type Role, type RoleOptions, type Screen, type ScreenNode, type ScrollDevice, type ScrollDirection, type ScrollSearch, type ScrollTrail, type SessionState, type Settled, type Size, type StepOptions, TOUCHPRESS_DEFAULTS, type TextMatch, type TextOptions, TouchpressError, type TouchpressOptions, type Tree, type Typed, type Verdict, captureEvidence, compareScreenshot, createDevice, createScrollSearch, cropScreenshot, describeCheck, describeQuery, deviceNameForSlot, directionToward, evaluate, formatFailure, normalizeText, openSession, parseDeviceOptions, parseScreen, preflight, probe, relativeTo, renderScreen, renderTitle, resolve, sessionName, silentSink, sizeOf, textMatch, toPixelBox };

package/dist/core/index.mjs

@@ -1,2 +1,2 @@
-import { A as textMatch, C as describeCheck, D as parseDeviceOptions, E as deviceNameForSlot, O as describeQuery, S as resolve, T as TANGERE_DEFAULTS, a as sizeOf, b as parseScreen, d as createScrollSearch, f as directionToward, g as sessionName, h as openSession, i as relativeTo, j as TangereError, k as normalizeText, l as captureEvidence, m as probe, n as compareScreenshot, o as toPixelBox, p as formatFailure, r as cropScreenshot, t as preflight, u as createDevice, v as renderTitle, w as evaluate, x as renderScreen, y as silentSink } from "../preflight-C83jCNPs.mjs";
-export { TANGERE_DEFAULTS, TangereError, captureEvidence, compareScreenshot, createDevice, createScrollSearch, cropScreenshot, describeCheck, describeQuery, deviceNameForSlot, directionToward, evaluate, formatFailure, normalizeText, openSession, parseDeviceOptions, parseScreen, preflight, probe, relativeTo, renderScreen, renderTitle, resolve, sessionName, silentSink, sizeOf, textMatch, toPixelBox };
+import { A as textMatch, C as describeCheck, D as parseDeviceOptions, E as deviceNameForSlot, O as describeQuery, S as resolve, T as TOUCHPRESS_DEFAULTS, a as sizeOf, b as parseScreen, d as createScrollSearch, f as directionToward, g as sessionName, h as openSession, i as relativeTo, j as TouchpressError, k as normalizeText, l as captureEvidence, m as probe, n as compareScreenshot, o as toPixelBox, p as formatFailure, r as cropScreenshot, t as preflight, u as createDevice, v as renderTitle, w as evaluate, x as renderScreen, y as silentSink } from "../preflight-DzSceNMx.mjs";
+export { TOUCHPRESS_DEFAULTS, TouchpressError, captureEvidence, compareScreenshot, createDevice, createScrollSearch, cropScreenshot, describeCheck, describeQuery, deviceNameForSlot, directionToward, evaluate, formatFailure, normalizeText, openSession, parseDeviceOptions, parseScreen, preflight, probe, relativeTo, renderScreen, renderTitle, resolve, sessionName, silentSink, sizeOf, textMatch, toPixelBox };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { E as ReadyQuery, _t as Screen, a as ExpectedValue, at as Filter, b as DeviceSession, ct as TextMatch, g as Locator, h as FilterOptions, ht as Rect, i as ErrorInfo, k as TangereOptions, n as PreflightReport, o as TangereError, ot as Query, p as Device, pt as Platform, r as preflight, st as Role, t as PreflightDevice, vt as ScreenNode } from "./preflight--Z-REtl-.mjs";
+import { E as ReadyQuery, _t as Screen, a as ExpectedValue, at as Filter, b as DeviceSession, ct as TextMatch, g as Locator, h as FilterOptions, ht as Rect, i as ErrorInfo, k as TouchpressOptions, n as PreflightReport, o as TouchpressError, ot as Query, p as Device, pt as Platform, r as preflight, st as Role, t as PreflightDevice, vt as ScreenNode } from "./preflight-CCKYplYi.mjs";
 import { ExpectMatcherState } from "@playwright/test";
 //#region src/playwright/fixtures.d.ts
 /**
- * Tangere's options and none of its fixtures, for a setup project that reads the
+ * Touchpress's options and none of its fixtures, for a setup project that reads the
  * configuration before any session exists, such as one calling `preflight`.
  *
  * `platform`, `app`, and `readyWhen` default to `undefined` rather than to a
@@ -10,7 +10,7 @@ import { ExpectMatcherState } from "@playwright/test";
  * type, and `parseDeviceOptions` rejects `undefined` by name, so a config that
  * forgot a key and one that never set it fail the same way.
  */
-declare const setupTest: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & object, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & TangereOptions>;
+declare const setupTest: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & object, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & TouchpressOptions>;
 /**
  * `device` is auto so evidence capture runs for every test in a device project,
  * whether or not the body touched it. Its teardown runs before the session's,
@@ -22,7 +22,7 @@ declare const setupTest: import("@playwright/test").TestType<import("@playwright
  */
 declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & object & {
   device: Device;
-}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & TangereOptions & {
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & TouchpressOptions & {
   session: DeviceSession;
 }>;
 //#endregion
@@ -73,4 +73,4 @@ declare const expect: import("@playwright/test").Expect<{
   }>;
 }>;
 //#endregion
-export { type Device, type ErrorInfo, type ExpectedValue, type Filter, type FilterOptions, type Locator, type Platform, type PreflightDevice, type PreflightReport, type Query, type ReadyQuery, type Rect, type Role, type Screen, type ScreenNode, type ScreenshotOptions, TangereError, type TangereOptions, type TextMatch, expect, preflight, setupTest, test };
+export { type Device, type ErrorInfo, type ExpectedValue, type Filter, type FilterOptions, type Locator, type Platform, type PreflightDevice, type PreflightReport, type Query, type ReadyQuery, type Rect, type Role, type Screen, type ScreenNode, type ScreenshotOptions, type TextMatch, TouchpressError, type TouchpressOptions, expect, preflight, setupTest, test };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as textMatch, D as parseDeviceOptions, S as resolve, T as TANGERE_DEFAULTS, _ as sleep, a as sizeOf, c as createClient, h as openSession, i as relativeTo, j as TangereError, l as captureEvidence, n as compareScreenshot, o as toPixelBox, r as cropScreenshot, s as createAgentDeviceDriver, t as preflight, u as createDevice, y as silentSink } from "./preflight-C83jCNPs.mjs";
+import { A as textMatch, D as parseDeviceOptions, S as resolve, T as TOUCHPRESS_DEFAULTS, _ as sleep, a as sizeOf, c as createClient, h as openSession, i as relativeTo, j as TouchpressError, l as captureEvidence, n as compareScreenshot, o as toPixelBox, r as cropScreenshot, s as createAgentDeviceDriver, t as preflight, u as createDevice, y as silentSink } from "./preflight-DzSceNMx.mjs";
 import { expect as expect$1, test as test$1 } from "@playwright/test";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
@@ -6,7 +6,7 @@ import { dirname } from "node:path";
 const SESSION_FIXTURE_TIMEOUT_MS = 18e4;
 const DEVICE_FIXTURE_TIMEOUT_MS = 12e4;
 /**
-* Tangere's options and none of its fixtures, for a setup project that reads the
+* Touchpress's options and none of its fixtures, for a setup project that reads the
 * configuration before any session exists, such as one calling `preflight`.
 *
 * `platform`, `app`, and `readyWhen` default to `undefined` rather than to a
@@ -35,31 +35,31 @@ const setupTest = test$1.extend({
 		option: true,
 		scope: "worker"
 	}],
-	relaunch: [TANGERE_DEFAULTS.relaunch, {
+	relaunch: [TOUCHPRESS_DEFAULTS.relaunch, {
 		option: true,
 		scope: "worker"
 	}],
-	onDeviceInUse: [TANGERE_DEFAULTS.onDeviceInUse, {
+	onDeviceInUse: [TOUCHPRESS_DEFAULTS.onDeviceInUse, {
 		option: true,
 		scope: "worker"
 	}],
-	settleQuietMs: [TANGERE_DEFAULTS.settleQuietMs, {
+	settleQuietMs: [TOUCHPRESS_DEFAULTS.settleQuietMs, {
 		option: true,
 		scope: "worker"
 	}],
-	launchTimeout: [TANGERE_DEFAULTS.launchTimeout, {
+	launchTimeout: [TOUCHPRESS_DEFAULTS.launchTimeout, {
 		option: true,
 		scope: "worker"
 	}],
-	dismissDevOverlay: [TANGERE_DEFAULTS.dismissDevOverlay, {
+	dismissDevOverlay: [TOUCHPRESS_DEFAULTS.dismissDevOverlay, {
 		option: true,
 		scope: "worker"
 	}],
-	evidence: [TANGERE_DEFAULTS.evidence, {
+	evidence: [TOUCHPRESS_DEFAULTS.evidence, {
 		option: true,
 		scope: "worker"
 	}],
-	sessionPrefix: [TANGERE_DEFAULTS.sessionPrefix, {
+	sessionPrefix: [TOUCHPRESS_DEFAULTS.sessionPrefix, {
 		option: true,
 		scope: "worker"
 	}]
@@ -436,4 +436,4 @@ const expect = expect$1.extend({
 	}
 });
 //#endregion
-export { TangereError, expect, preflight, setupTest, test };
+export { TouchpressError, expect, preflight, setupTest, test };

package/dist/{preflight--Z-REtl-.d.mts → preflight-CCKYplYi.d.mts}

@@ -323,7 +323,7 @@ type CaptureOptions = {
  * Contract every implementation owes the core. `open` converges when called on
  * an already-open session. Mutations take a `PinnedRef` and never a selector, so
  * the driver's own matcher is never a second opinion on which node was meant.
- * Every failure throws a `TangereError` carrying a `DeviceFailure`.
+ * Every failure throws a `TouchpressError` carrying a `DeviceFailure`.
  */
 type DeviceDriver = {
   /** Takes no session, so it is the one call that binds nothing. */
@@ -475,14 +475,14 @@ declare const silentSink: ActionSink;
 //#endregion
 //#region src/core/config.d.ts
 /**
- * The keys tangere adds to Playwright's `use`. Each is its own option fixture, so
+ * The keys touchpress adds to Playwright's `use`. Each is its own option fixture, so
  * a project overrides one without restating the rest.
  *
  * Playwright types `use` as a partial of this, so a config may leave any key out.
  * `parseDeviceOptions` is what makes `platform`, `app`, and `readyWhen` required.
  * It runs once at worker start and nothing downstream re-validates.
  */
-type TangereOptions = {
+type TouchpressOptions = {
   /** Required. */
   platform: Platform | undefined;
   /** Required. Bundle id on iOS, package name on Android. Never a path to an artifact. */
@@ -513,7 +513,7 @@ type TangereOptions = {
   dismissDevOverlay: boolean;
   /** @default 'on-failure' */
   evidence: 'on-failure' | 'always' | 'off';
-  /** @default 'tangere'. Session names are `${prefix}-${project}-${parallelIndex}`. */
+  /** @default 'touchpress'. Session names are `${prefix}-${project}-${parallelIndex}`. */
   sessionPrefix: string;
 };
 /**
@@ -521,7 +521,7 @@ type TangereOptions = {
  * to the same values, so a caller that reaches the parser without the fixtures,
  * such as `preflight`, resolves identically.
  */
-declare const TANGERE_DEFAULTS: Omit<TangereOptions, 'platform' | 'app' | 'readyWhen' | 'deviceName' | 'launchUrl'>;
+declare const TOUCHPRESS_DEFAULTS: Omit<TouchpressOptions, 'platform' | 'app' | 'readyWhen' | 'deviceName' | 'launchUrl'>;
 /** The config-file friendly subset of a locator. Matched by the same rules as any other query. */
 type ReadyQuery = {
   text: string;
@@ -826,7 +826,7 @@ type ErrorInfo = {
   readonly command: string;
   readonly failure: DeviceFailure;
 };
-declare class TangereError extends Error {
+declare class TouchpressError extends Error {
   readonly info: ErrorInfo;
   constructor(info: ErrorInfo);
 }
@@ -848,6 +848,6 @@ type PreflightReport = {
  * runner names every one of them at once. A malformed config still throws, the
  * way it does everywhere else. `driver` is the seam tests inject.
  */
-declare function preflight(options: Partial<TangereOptions>, driver?: DeviceDriver): Promise<PreflightReport>;
+declare function preflight(options: Partial<TouchpressOptions>, driver?: DeviceDriver): Promise<PreflightReport>;
 //#endregion
-export { Tree as $, deviceNameForSlot as A, ProbeResult as B, openSession as C, ResolvedOptions as D, ReadyQuery as E, StepOptions as F, CaptureOptions as G, formatFailure as H, Typed as I, DeviceInfo as J, DeviceDriver as K, renderTitle as L, ActionRecord as M, ActionSink as N, TANGERE_DEFAULTS as O, EvidenceFile as P, Settled as Q, silentSink as R, SessionState as S, DeviceChoice as T, probe as U, ProbeTarget as V, Binding as W, OpenRequest as X, DeviceSelection as Y, ScrollDirection as Z, RoleOptions as _, Screen as _t, ExpectedValue as a, Filter as at, DeviceSession as b, renderScreen as bt, ScrollSearch as c, TextMatch as ct, directionToward as d, textMatch as dt, Check as et, ActionOptions as f, PinnedRef as ft, Locator as g, Resolution as gt, FilterOptions as h, Rect as ht, ErrorInfo as i, evaluate as it, parseDeviceOptions as j, TangereOptions as k, ScrollTrail as l, describeQuery as lt, FillOptions as m, RawSnapshot as mt, PreflightReport as n, Verdict as nt, TangereError as o, Query as ot, Device as p, Platform as pt, DeviceFailure as q, preflight as r, describeCheck as rt, ScrollDevice as s, Role as st, PreflightDevice as t, CheckName as tt, createScrollSearch as u, normalizeText as ut, TextOptions as v, ScreenNode as vt, sessionName as w, OpenSessionInput as x, resolve as xt, createDevice as y, parseScreen as yt, ProbeOptions as z };
+export { Tree as $, deviceNameForSlot as A, ProbeResult as B, openSession as C, ResolvedOptions as D, ReadyQuery as E, StepOptions as F, CaptureOptions as G, formatFailure as H, Typed as I, DeviceInfo as J, DeviceDriver as K, renderTitle as L, ActionRecord as M, ActionSink as N, TOUCHPRESS_DEFAULTS as O, EvidenceFile as P, Settled as Q, silentSink as R, SessionState as S, DeviceChoice as T, probe as U, ProbeTarget as V, Binding as W, OpenRequest as X, DeviceSelection as Y, ScrollDirection as Z, RoleOptions as _, Screen as _t, ExpectedValue as a, Filter as at, DeviceSession as b, renderScreen as bt, ScrollSearch as c, TextMatch as ct, directionToward as d, textMatch as dt, Check as et, ActionOptions as f, PinnedRef as ft, Locator as g, Resolution as gt, FilterOptions as h, Rect as ht, ErrorInfo as i, evaluate as it, parseDeviceOptions as j, TouchpressOptions as k, ScrollTrail as l, describeQuery as lt, FillOptions as m, RawSnapshot as mt, PreflightReport as n, Verdict as nt, TouchpressError as o, Query as ot, Device as p, Platform as pt, DeviceFailure as q, preflight as r, describeCheck as rt, ScrollDevice as s, Role as st, PreflightDevice as t, CheckName as tt, createScrollSearch as u, normalizeText as ut, TextOptions as v, ScreenNode as vt, sessionName as w, OpenSessionInput as x, resolve as xt, createDevice as y, parseScreen as yt, ProbeOptions as z };

package/dist/{preflight-C83jCNPs.mjs → preflight-DzSceNMx.mjs}

@@ -2,17 +2,17 @@ import { createAgentDeviceClient, normalizeAgentDeviceError } from "agent-device
 import pixelmatch from "pixelmatch";
 import { PNG } from "pngjs";
 //#region src/core/errors.ts
-var TangereError = class extends Error {
+var TouchpressError = class extends Error {
 	info;
 	constructor(info) {
 		super(formatError(info));
-		this.name = "TangereError";
+		this.name = "TouchpressError";
 		this.info = info;
 	}
 };
 function formatError(info) {
 	switch (info.kind) {
-		case "config": return `Invalid tangere option: use.${info.field} ${info.detail}`;
+		case "config": return `Invalid touchpress option: use.${info.field} ${info.detail}`;
 		case "device-in-use": return [
 			`Device ${info.device} is held by ${info.owner === null ? "another session" : `session "${info.owner}"`}.`,
 			`Release it with: ${info.releaseCommand}`,
@@ -183,14 +183,14 @@ function describeIndex(index) {
 * to the same values, so a caller that reaches the parser without the fixtures,
 * such as `preflight`, resolves identically.
 */
-const TANGERE_DEFAULTS = {
+const TOUCHPRESS_DEFAULTS = {
 	relaunch: "per-test",
 	onDeviceInUse: "fail",
 	settleQuietMs: 500,
 	launchTimeout: 9e4,
 	dismissDevOverlay: false,
 	evidence: "on-failure",
-	sessionPrefix: "tangere"
+	sessionPrefix: "touchpress"
 };
 const DEFAULT_ACTION_TIMEOUT_MS = 1e4;
 const ROLES = [
@@ -226,18 +226,18 @@ function parseDeviceOptions(raw) {
 		readyWhen: parseReadyWhen(read(raw, "readyWhen")),
 		device: parseDeviceChoice(read(raw, "deviceName")),
 		launchUrl: optionalText("launchUrl", read(raw, "launchUrl")),
-		relaunch: oneOf("relaunch", read(raw, "relaunch"), ["per-test", "per-worker"], TANGERE_DEFAULTS.relaunch),
-		onDeviceInUse: oneOf("onDeviceInUse", read(raw, "onDeviceInUse"), ["fail", "reclaim"], TANGERE_DEFAULTS.onDeviceInUse),
+		relaunch: oneOf("relaunch", read(raw, "relaunch"), ["per-test", "per-worker"], TOUCHPRESS_DEFAULTS.relaunch),
+		onDeviceInUse: oneOf("onDeviceInUse", read(raw, "onDeviceInUse"), ["fail", "reclaim"], TOUCHPRESS_DEFAULTS.onDeviceInUse),
 		actionTimeout: parseActionTimeout(read(raw, "actionTimeout")),
-		settleQuietMs: positive("settleQuietMs", read(raw, "settleQuietMs"), TANGERE_DEFAULTS.settleQuietMs),
-		launchTimeout: positive("launchTimeout", read(raw, "launchTimeout"), TANGERE_DEFAULTS.launchTimeout),
-		dismissDevOverlay: flag("dismissDevOverlay", read(raw, "dismissDevOverlay"), TANGERE_DEFAULTS.dismissDevOverlay),
+		settleQuietMs: positive("settleQuietMs", read(raw, "settleQuietMs"), TOUCHPRESS_DEFAULTS.settleQuietMs),
+		launchTimeout: positive("launchTimeout", read(raw, "launchTimeout"), TOUCHPRESS_DEFAULTS.launchTimeout),
+		dismissDevOverlay: flag("dismissDevOverlay", read(raw, "dismissDevOverlay"), TOUCHPRESS_DEFAULTS.dismissDevOverlay),
 		evidence: oneOf("evidence", read(raw, "evidence"), [
 			"on-failure",
 			"always",
 			"off"
-		], TANGERE_DEFAULTS.evidence),
-		sessionPrefix: text("sessionPrefix", read(raw, "sessionPrefix"), TANGERE_DEFAULTS.sessionPrefix)
+		], TOUCHPRESS_DEFAULTS.evidence),
+		sessionPrefix: text("sessionPrefix", read(raw, "sessionPrefix"), TOUCHPRESS_DEFAULTS.sessionPrefix)
 	};
 }
 /** A non-object source reads as every key unset, so a caller that passes nothing fails on the first required key. */
@@ -246,7 +246,7 @@ function read(source, key) {
 	return key in source ? Reflect.get(source, key) : void 0;
 }
 /**
-* Playwright's own `use.actionTimeout`, not one of tangere's. Playwright defaults
+* Playwright's own `use.actionTimeout`, not one of touchpress's. Playwright defaults
 * it to 0, which means "no timeout" there and would mean "give up at once" here,
 * so 0 falls back the way an unset value does.
 */
@@ -348,7 +348,7 @@ function text(field, value, fallback) {
 	return value;
 }
 function fail(field, detail) {
-	return new TangereError({
+	return new TouchpressError({
 		kind: "config",
 		field,
 		detail
@@ -806,7 +806,7 @@ async function openWithRecovery(driver, options, name, deviceName) {
 		if (failure === null) throw error;
 		if (failure.kind === "device-busy") {
 			const owner = failure.owner;
-			if (!(owner !== null && (owner.startsWith(options.sessionPrefix) || options.onDeviceInUse === "reclaim"))) throw new TangereError({
+			if (!(owner !== null && (owner.startsWith(options.sessionPrefix) || options.onDeviceInUse === "reclaim"))) throw new TouchpressError({
 				kind: "device-in-use",
 				owner,
 				device: deviceName ?? options.platform,
@@ -820,7 +820,7 @@ async function openWithRecovery(driver, options, name, deviceName) {
 			await driver.close(name);
 			return await driver.open(request);
 		}
-		throw new TangereError({
+		throw new TouchpressError({
 			kind: "launch-failed",
 			app: options.app,
 			device: deviceName ?? options.platform,
@@ -877,7 +877,7 @@ function createSession(driver, options, name, binding) {
 			if (remaining <= 0) break;
 			await sleep(Math.min(READY_POLL_MS, remaining));
 		}
-		throw new TangereError({
+		throw new TouchpressError({
 			kind: "not-ready",
 			locator: describeQuery(options.readyWhen),
 			timeoutMs: Date.now() - started,
@@ -920,12 +920,12 @@ function createSession(driver, options, name, binding) {
 	};
 }
 function unusable(state) {
-	if (state.phase === "broken") return new TangereError({
+	if (state.phase === "broken") return new TouchpressError({
 		kind: "driver",
 		command: "device command",
 		failure: state.failure
 	});
-	return new TangereError({
+	return new TouchpressError({
 		kind: "session-closed",
 		command: "run a device command"
 	});
@@ -943,7 +943,7 @@ function sessionName(options, project, slot) {
 	return `${options.sessionPrefix}-${project === "" ? "default" : project}-${String(slot)}`;
 }
 function failureOf(error) {
-	if (!(error instanceof TangereError)) return null;
+	if (!(error instanceof TouchpressError)) return null;
 	if (error.info.kind === "driver") return error.info.failure;
 	if (error.info.kind === "launch-failed") return error.info.failure;
 	return null;
@@ -1240,7 +1240,7 @@ function perform(session, sink, record, options, dispatch, write) {
 			let target = record.query;
 			let lastActual = null;
 			let screen = await device.capture();
-			const unconfirmed = (expected) => new TangereError({
+			const unconfirmed = (expected) => new TouchpressError({
 				kind: "fill-unconfirmed",
 				locator,
 				expected,
@@ -1288,7 +1288,7 @@ function perform(session, sink, record, options, dispatch, write) {
 					continue;
 				}
 				const remaining = deadline - Date.now();
-				if (remaining <= 0) throw new TangereError({
+				if (remaining <= 0) throw new TouchpressError({
 					kind: "not-found",
 					locator,
 					timeoutMs: timeout,
@@ -1326,7 +1326,7 @@ function scrollIntoView(session, sink, query, options) {
 				if (resolution.outcome === "many") throw ambiguous(locator, resolution.nodes, screen);
 				if (resolution.outcome === "one") return;
 				const remaining = deadline - Date.now();
-				if (remaining <= 0 || !await search.step(screen, query, remaining)) throw new TangereError({
+				if (remaining <= 0 || !await search.step(screen, query, remaining)) throw new TouchpressError({
 					kind: "not-found",
 					locator,
 					timeoutMs: timeout,
@@ -1349,7 +1349,7 @@ function reportingScrolls(device, sink) {
 	};
 }
 function ambiguous(locator, nodes, screen) {
-	return new TangereError({
+	return new TouchpressError({
 		kind: "strict-mode",
 		locator,
 		matches: nodes.map((node) => describeNode(node)),
@@ -1495,7 +1495,7 @@ function createAgentDeviceDriver(client, session, selection) {
 		try {
 			return await body();
 		} catch (error) {
-			throw new TangereError({
+			throw new TouchpressError({
 				kind: "driver",
 				command,
 				failure: classifyError(error)
@@ -1862,4 +1862,4 @@ function notBooted(platform, name, booted) {
 	return `No booted ${platform} device is named '${name}'. Booted right now: ${booted.map((device) => `'${device.name}'`).join(", ")}. Set use.deviceName to one of those or boot '${name}'.`;
 }
 //#endregion
-export { textMatch as A, describeCheck as C, parseDeviceOptions as D, deviceNameForSlot as E, describeQuery as O, resolve as S, TANGERE_DEFAULTS as T, sleep as _, sizeOf as a, parseScreen as b, createClient as c, createScrollSearch as d, directionToward as f, sessionName as g, openSession as h, relativeTo as i, TangereError as j, normalizeText as k, captureEvidence as l, probe as m, compareScreenshot as n, toPixelBox as o, formatFailure as p, cropScreenshot as r, createAgentDeviceDriver as s, preflight as t, createDevice as u, renderTitle as v, evaluate as w, renderScreen as x, silentSink as y };
+export { textMatch as A, describeCheck as C, parseDeviceOptions as D, deviceNameForSlot as E, describeQuery as O, resolve as S, TOUCHPRESS_DEFAULTS as T, sleep as _, sizeOf as a, parseScreen as b, createClient as c, createScrollSearch as d, directionToward as f, sessionName as g, openSession as h, relativeTo as i, TouchpressError as j, normalizeText as k, captureEvidence as l, probe as m, compareScreenshot as n, toPixelBox as o, formatFailure as p, cropScreenshot as r, createAgentDeviceDriver as s, preflight as t, createDevice as u, renderTitle as v, evaluate as w, renderScreen as x, silentSink as y };

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "touchpress",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "End-to-end testing for mobile apps.",
-  "homepage": "https://github.com/wobsoriano/tangere#readme",
+  "homepage": "https://github.com/wobsoriano/touchpress#readme",
   "bugs": {
-    "url": "https://github.com/wobsoriano/tangere/issues"
+    "url": "https://github.com/wobsoriano/touchpress/issues"
   },
   "license": "MIT",
   "author": "Robert Soriano",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/wobsoriano/tangere.git"
+    "url": "git+https://github.com/wobsoriano/touchpress.git"
   },
   "files": [
     "dist"