@specific.dev/spectest 0.68.0 → 0.69.0

package/dist/browser.js

@@ -1406,7 +1406,7 @@ function buildBackend(holder, recorder, buildOpts) {
             }, { wrap: true });
         },
         async waitForFunction(description, fn, arg, options = {}) {
-            const timeoutMs = options.timeout ?? 5_000;
+            const timeoutMs = options.timeout ?? DEFAULT_ACTION_TIMEOUT_MS;
             const intervalMs = options.polling ?? 100;
             const src = typeof fn === "string" ? fn : fn.toString();
             const t = truncateUtf8(src);

package/dist/index.js

@@ -713,7 +713,7 @@ function buildLocatorMatchers(loc, negated, message) {
         // The last error a probe threw, kept for the failure message: a matcher
         // whose read waits for the element (textContent, inputValue, isEnabled …)
         // reports a missing element as a playwright timeout, and that — not
-        // "got <error: Timeout 5000ms exceeded …>" — is the sentence to fail with.
+        // "got <error: Timeout 10000ms exceeded …>" — is the sentence to fail with.
         let probeError;
         for (;;) {
             let satisfied;
@@ -753,8 +753,8 @@ function buildLocatorMatchers(loc, negated, message) {
             }
             if (Date.now() >= deadline) {
                 // The deadline, not the stopwatch: every one of these polled until it
-                // ran out, and "(waited 5s)" is both what the author set and the same
-                // number twice in a row — a measured 4_987ms is neither.
+                // ran out, and "(waited 10s)" is both what the author set and the same
+                // number twice in a row — a measured 9_987ms is neither.
                 const msg = (await elementFailure(probeError)) ??
                     `${describe(actual)} (waited ${formatWaited(budget)})`;
                 const sourceSeq = await probe.settle(matcher, Date.now() - started, msg, settleOpts);

package/dist/locator-errors.js

@@ -1,7 +1,7 @@
 // Readable failures for locator steps.
 //
 // Playwright reports every unmet actionability wait the same way: a
-// `TimeoutError` whose message is "Timeout 5000ms exceeded." with the real
+// `TimeoutError` whose message is "Timeout 10000ms exceeded." with the real
 // story — did the element exist at all? was it disabled? did something cover
 // it? — buried in a call log below it. A test that clicks a button that is not
 // on the page therefore fails with a sentence about OUR deadline, which reads

package/dist/locator.d.ts

@@ -3,11 +3,16 @@ import type { RecordableFields } from "./browser.js";
 import type { Wrapped } from "./inspect.js";
 import { type HintTarget } from "./locator-hints.js";
 /** Default deadline for a locator action/read's target to become actionable.
- *  Playwright's own default is 30s — far too slow-failing for tests; 5s
- *  matches the pre-Playwright behavior. A per-call `{ timeout }` overrides it;
- *  `undefined` falls through to the context default (also set to this in
- *  browser.ts's `newViewContext`). Navigations keep a longer deadline. */
-export declare const DEFAULT_ACTION_TIMEOUT_MS = 5000;
+ *  Playwright's own default is 30s — far too slow-failing for tests. This was
+ *  5s (the pre-Playwright behavior) until 2026-09-03, and 5s turned out to be
+ *  about one page load: a real app under a full VM fan-out took 1.8-2.0s for a
+ *  full navigation plus its client data chain on a quiet box, and 4x that on
+ *  the tail, so a step that was correct and merely late failed. 10s still
+ *  fails fast enough to be useful and leaves room for the tail. A per-call
+ *  `{ timeout }` overrides it; `undefined` falls through to the context
+ *  default (also set to this in browser.ts's `newViewContext`). Navigations
+ *  keep a longer deadline. */
+export declare const DEFAULT_ACTION_TIMEOUT_MS = 10000;
 export interface GetByTextOptions {
     /** Whole-string, case-sensitive match instead of the default
      *  case-insensitive substring. Ignored when the query is a RegExp. */

package/dist/locator.js

@@ -27,11 +27,16 @@ import { formatHints, nearMissHints } from "./locator-hints.js";
 import { resolveExistingProjectPath } from "./project-files.js";
 import { truncateUtf8 } from "./recorder.js";
 /** Default deadline for a locator action/read's target to become actionable.
- *  Playwright's own default is 30s — far too slow-failing for tests; 5s
- *  matches the pre-Playwright behavior. A per-call `{ timeout }` overrides it;
- *  `undefined` falls through to the context default (also set to this in
- *  browser.ts's `newViewContext`). Navigations keep a longer deadline. */
-export const DEFAULT_ACTION_TIMEOUT_MS = 5_000;
+ *  Playwright's own default is 30s — far too slow-failing for tests. This was
+ *  5s (the pre-Playwright behavior) until 2026-09-03, and 5s turned out to be
+ *  about one page load: a real app under a full VM fan-out took 1.8-2.0s for a
+ *  full navigation plus its client data chain on a quiet box, and 4x that on
+ *  the tail, so a step that was correct and merely late failed. 10s still
+ *  fails fast enough to be useful and leaves room for the tail. A per-call
+ *  `{ timeout }` overrides it; `undefined` falls through to the context
+ *  default (also set to this in browser.ts's `newViewContext`). Navigations
+ *  keep a longer deadline. */
+export const DEFAULT_ACTION_TIMEOUT_MS = 10_000;
 // Brand + chain carrier. Both are `Symbol.for` keys so `JSON.stringify` drops
 // them (locators are never serialized) while runtime code can still detect a
 // locator and read a nested one's chain during lowering.
@@ -401,7 +406,7 @@ export function makeLocator(backend, strategy, chain) {
         return formatHints(await nearMissHints(page, target));
     };
     // Every terminal op runs through this: playwright's actionability timeouts
-    // say "Timeout 5000ms exceeded" and hide what actually went wrong in a call
+    // say "Timeout 10000ms exceeded" and hide what actually went wrong in a call
     // log, so they are rewritten into a sentence naming the element and its
     // state (see locator-errors.ts), and a failure that found NO element asks
     // the page what it does hold. Applied INSIDE `pageOp`, so the recorded step

package/dist/terminal.js

@@ -28,6 +28,9 @@
 import { Terminal as XtermHeadless } from "@xterm/headless";
 import { recordTerminalStep, reserveEvent, truncateUtf8 } from "./recorder.js";
 import { wrap } from "./inspect.js";
+// One default deadline for "wait until the app shows it", whichever surface
+// the author is watching — see the constant for why it is what it is.
+import { DEFAULT_ACTION_TIMEOUT_MS } from "./locator.js";
 // Cap on cumulative output we keep in memory. The asciicast frames
 // grow separately (they live on the session record) and aren't bounded
 // here. Matches `TERMINAL_OUTPUT_CAP_BYTES` in daemon.ts.
@@ -421,7 +424,7 @@ export async function openTerminal(args) {
             return renderScreen();
         },
         async waitFor(description, matcher, waitOpts) {
-            const timeoutMs = waitOpts?.timeoutMs ?? 5_000;
+            const timeoutMs = waitOpts?.timeoutMs ?? DEFAULT_ACTION_TIMEOUT_MS;
             const intervalMs = waitOpts?.intervalMs ?? 100;
             const t = Date.now();
             const resv = reserveEvent();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/spectest",
-  "version": "0.68.0",
+  "version": "0.69.0",
   "description": "Spectest SDK for defining test environments in TypeScript.",
   "type": "module",
   "main": "./dist/index.js",

package/src/browser.ts

@@ -1943,7 +1943,7 @@ function buildBackend(
       arg?: unknown,
       options: { timeout?: number; polling?: number } = {},
     ): Promise<Wrapped<T>> {
-      const timeoutMs = options.timeout ?? 5_000;
+      const timeoutMs = options.timeout ?? DEFAULT_ACTION_TIMEOUT_MS;
       const intervalMs = options.polling ?? 100;
       const src = typeof fn === "string" ? fn : fn.toString();
       const t = truncateUtf8(src);

package/src/index.ts

@@ -2900,7 +2900,7 @@ function buildLocatorMatchers(
     // The last error a probe threw, kept for the failure message: a matcher
     // whose read waits for the element (textContent, inputValue, isEnabled …)
     // reports a missing element as a playwright timeout, and that — not
-    // "got <error: Timeout 5000ms exceeded …>" — is the sentence to fail with.
+    // "got <error: Timeout 10000ms exceeded …>" — is the sentence to fail with.
     let probeError: unknown;
     for (;;) {
       let satisfied: boolean;
@@ -2939,8 +2939,8 @@ function buildLocatorMatchers(
       }
       if (Date.now() >= deadline) {
         // The deadline, not the stopwatch: every one of these polled until it
-        // ran out, and "(waited 5s)" is both what the author set and the same
-        // number twice in a row — a measured 4_987ms is neither.
+        // ran out, and "(waited 10s)" is both what the author set and the same
+        // number twice in a row — a measured 9_987ms is neither.
         const msg = (await elementFailure(probeError)) ??
           `${describe(actual)} (waited ${formatWaited(budget)})`;
         const sourceSeq = await probe.settle(matcher, Date.now() - started, msg, settleOpts);

package/src/locator-errors.ts

@@ -1,7 +1,7 @@
 // Readable failures for locator steps.
 //
 // Playwright reports every unmet actionability wait the same way: a
-// `TimeoutError` whose message is "Timeout 5000ms exceeded." with the real
+// `TimeoutError` whose message is "Timeout 10000ms exceeded." with the real
 // story — did the element exist at all? was it disabled? did something cover
 // it? — buried in a call log below it. A test that clicks a button that is not
 // on the page therefore fails with a sentence about OUR deadline, which reads

package/src/locator.ts

@@ -32,11 +32,16 @@ import { resolveExistingProjectPath } from "./project-files.js";
 import { truncateUtf8 } from "./recorder.js";
 
 /** Default deadline for a locator action/read's target to become actionable.
- *  Playwright's own default is 30s — far too slow-failing for tests; 5s
- *  matches the pre-Playwright behavior. A per-call `{ timeout }` overrides it;
- *  `undefined` falls through to the context default (also set to this in
- *  browser.ts's `newViewContext`). Navigations keep a longer deadline. */
-export const DEFAULT_ACTION_TIMEOUT_MS = 5_000;
+ *  Playwright's own default is 30s — far too slow-failing for tests. This was
+ *  5s (the pre-Playwright behavior) until 2026-09-03, and 5s turned out to be
+ *  about one page load: a real app under a full VM fan-out took 1.8-2.0s for a
+ *  full navigation plus its client data chain on a quiet box, and 4x that on
+ *  the tail, so a step that was correct and merely late failed. 10s still
+ *  fails fast enough to be useful and leaves room for the tail. A per-call
+ *  `{ timeout }` overrides it; `undefined` falls through to the context
+ *  default (also set to this in browser.ts's `newViewContext`). Navigations
+ *  keep a longer deadline. */
+export const DEFAULT_ACTION_TIMEOUT_MS = 10_000;
 
 // Brand + chain carrier. Both are `Symbol.for` keys so `JSON.stringify` drops
 // them (locators are never serialized) while runtime code can still detect a
@@ -656,7 +661,7 @@ export interface Locator {
   /** Explicit strict-mode opt-out: the i-th resolved element (0-based). */
   nth(index: number): Locator;
 
-  // ── Actions (auto-wait; default 5s, `{ timeout }` overrides) ──────────
+  // ── Actions (auto-wait; default 10s, `{ timeout }` overrides) ─────────
   click(opts?: ClickOptions): Promise<void>;
   dblclick(opts?: ClickOptions): Promise<void>;
   /** Touch-tap (mobile sessions only; throws on desktop). `duration`
@@ -761,7 +766,7 @@ export function makeLocator(
   };
 
   // Every terminal op runs through this: playwright's actionability timeouts
-  // say "Timeout 5000ms exceeded" and hide what actually went wrong in a call
+  // say "Timeout 10000ms exceeded" and hide what actually went wrong in a call
   // log, so they are rewritten into a sentence naming the element and its
   // state (see locator-errors.ts), and a failure that found NO element asks
   // the page what it does hold. Applied INSIDE `pageOp`, so the recorded step

package/src/terminal.ts

@@ -32,6 +32,9 @@ import { recordTerminalStep, reserveEvent, truncateUtf8 } from "./recorder.js";
 import type { EventReservation } from "./recorder.js";
 import type { TerminalStepAction } from "./recorder.js";
 import { wrap } from "./inspect.js";
+// One default deadline for "wait until the app shows it", whichever surface
+// the author is watching — see the constant for why it is what it is.
+import { DEFAULT_ACTION_TIMEOUT_MS } from "./locator.js";
 import type { Wrapped } from "./inspect.js";
 
 export interface TerminalOpts {
@@ -614,7 +617,7 @@ export async function openTerminal(args: OpenTerminalArgs): Promise<InternalTerm
       matcher: string | RegExp | ((screen: string, output: string) => unknown),
       waitOpts?: { timeoutMs?: number; intervalMs?: number },
     ) {
-      const timeoutMs = waitOpts?.timeoutMs ?? 5_000;
+      const timeoutMs = waitOpts?.timeoutMs ?? DEFAULT_ACTION_TIMEOUT_MS;
       const intervalMs = waitOpts?.intervalMs ?? 100;
       const t = Date.now();
       const resv = reserveEvent();