@specific.dev/spectest 0.23.0 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/spectest",
-  "version": "0.23.0",
+  "version": "0.26.0",
   "description": "Spectest SDK for defining test environments in TypeScript.",
   "type": "module",
   "main": "./src/index.ts",

package/src/browser.ts

@@ -403,6 +403,12 @@ function deviceContextOptions(d: DevicePreset) {
     isMobile: d.isMobile,
     hasTouch: d.hasTouch,
     userAgent: d.userAgent,
+    // Emulate `prefers-reduced-motion: reduce` for replay fidelity — an app
+    // that honors it skips entrance animations/transitions, so rrweb's
+    // per-op FullSnapshot captures the settled DOM instead of a mid-fade
+    // (opacity 0) frame that a paused seek would freeze on. Applied at every
+    // newContext site below so all sessions record the same way.
+    reducedMotion: "reduce" as const,
   };
 }
 
@@ -411,6 +417,8 @@ async function ensureDesktopContext(): Promise<BrowserContext> {
   if (DESKTOP_CTX) return DESKTOP_CTX;
   DESKTOP_CTX = await browser.newContext({
     viewport: { width: 1280, height: 720 },
+    // Reduced-motion for replay fidelity — see deviceContextOptions.
+    reducedMotion: "reduce",
   });
   DESKTOP_CTX.setDefaultTimeout(DEFAULT_ACTION_TIMEOUT_MS);
   DESKTOP_CTX.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);
@@ -1031,7 +1039,11 @@ async function contextFor(
     return { context: await ensureDesktopContext(), ownsContext: false };
   }
   const browser = await ensurePlaywrightBrowser();
-  const context = await browser.newContext({ viewport: { width, height } });
+  const context = await browser.newContext({
+    viewport: { width, height },
+    // Reduced-motion for replay fidelity — see deviceContextOptions.
+    reducedMotion: "reduce",
+  });
   context.setDefaultTimeout(DEFAULT_ACTION_TIMEOUT_MS);
   context.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);
   return { context, ownsContext: true };

package/src/components/expo.ts

@@ -35,6 +35,13 @@ export interface ExpoOptions {
    * too late. Everything else applies to the static-server container only.
    */
   env?: Record<string, string>;
+  /**
+   * Script installed before each `ctx.mobile(ctx.svc.app)` session's first
+   * navigation, so it runs ahead of the app bundle on the very first document
+   * — no relaunch. Declare shims here once (reduced-motion, `Notification`, …)
+   * instead of calling them at the top of every test.
+   */
+  initScript?: string;
 }
 
 /** The handle `expo()` exposes on `ctx.svc.<name>` — a {@link MobileApp}. */
@@ -154,7 +161,7 @@ ${publicEnvLines ? `${publicEnvLines}\n` : ""}RUN npx expo export --platform web
       // TLS → net::ERR_SSL_PROTOCOL_ERROR), while a dotted host navigates as
       // plain HTTP. Node-side `fetch` is unaffected, but the mobile session
       // drives a real browser, so the URL must be browser-navigable.
-      return mobileApp(`http://${name}.internal:${port}`);
+      return mobileApp(`http://${name}.internal:${port}`, opts.initScript);
     },
   } satisfies ServiceDefinition<ExpoHelpers>;
 }

package/src/daemon.ts

@@ -3973,6 +3973,7 @@ async function runOne(testCase: TestCase<unknown>): Promise<RunResult> {
     const { mobile, attached, detach, safeAreaInsets } = await openPersistentMobile({
       url: app.url,
       recorder: session.recorder,
+      initScript: app.initScript,
     });
     if (safeAreaInsets) session.record.safeAreaInsets = safeAreaInsets;
     if (attached && session.record.initialUrl === undefined) {
@@ -4295,6 +4296,7 @@ async function evalCode(
     const { mobile, attached, detach, safeAreaInsets } = await openPersistentMobile({
       url: app.url,
       recorder: session.recorder,
+      initScript: app.initScript,
     });
     if (safeAreaInsets) session.record.safeAreaInsets = safeAreaInsets;
     if (attached && session.record.initialUrl === undefined) {

package/src/mobile.ts

@@ -36,6 +36,11 @@ export interface MobileApp {
   readonly [MOBILE_APP]: true;
   /** Resolved in-VM URL of the app's web build (e.g. `http://app.internal:8081`). */
   readonly url: string;
+  /** Optional script installed before the session's first navigation, so it
+   *  runs ahead of the app bundle on the very first document (no relaunch) —
+   *  the place to plant reduced-motion / `Notification` shims once for every
+   *  `ctx.mobile(app)` call. Set via `expo({ initScript })`. */
+  readonly initScript?: string;
 }
 
 /** True if `x` is a {@link MobileApp} handle. */
@@ -48,9 +53,10 @@ export function isMobileApp(x: unknown): x is MobileApp {
   );
 }
 
-/** Build a {@link MobileApp} handle from a resolved URL. */
-export function mobileApp(url: string): MobileApp {
-  return { [MOBILE_APP]: true, url };
+/** Build a {@link MobileApp} handle from a resolved URL (and an optional
+ *  init script installed before the session's first navigation). */
+export function mobileApp(url: string, initScript?: string): MobileApp {
+  return { [MOBILE_APP]: true, url, initScript };
 }
 
 // ────────────────────────────────────────────────────────────────────────
@@ -102,6 +108,9 @@ export async function openMobile(opts: {
 export async function openPersistentMobile(opts: {
   url: string;
   recorder: BrowserSessionRecorder | null;
+  /** Installed before the fresh session's first navigation (ignored on an
+   *  attached session, which already carries it on the forked holder). */
+  initScript?: string;
 }): Promise<{
   mobile: Mobile;
   attached: boolean;
@@ -113,6 +122,7 @@ export async function openPersistentMobile(opts: {
   const { browser, attached, detach } = await acquirePersistentMobileBackend(
     opts.url,
     opts.recorder,
+    opts.initScript,
   );
   return {
     mobile: browser,

package/src/recorder.ts

@@ -375,7 +375,7 @@ export interface EnvEvent extends BaseEvent {
 // method name verbatim. Both renderers (control-plane web + CLI) treat it as
 // an opaque string with a generic `{action} <target>` fallback, so new method
 // names need no Rust change. Representative values: "goto", "goBack",
-// "goForward", "reload", "evaluate", "addInitScript", "waitForFunction",
+// "goForward", "reload", "evaluate", "waitForFunction",
 // "click", "dblclick", "tap", "fill", "clear", "press", "type", "scroll",
 // "check", "hover", "textContent", "inputValue", "count", "screenshot".
 export type BrowserAction = string;