@specific.dev/spectest 0.17.0 → 0.17.1

package/package.json

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

package/src/daemon.ts

@@ -2967,6 +2967,13 @@ interface BrowserSessionRecord {
    * (phone bezel). Drives the dashboard's chrome; the rrweb events are
    * identical either way. */
   frame?: "browser" | "mobile";
+  /** Safe-area insets that were CDP-emulated during capture (mobile
+   * sessions on a Chromium that supports the override). The dashboard
+   * substitutes these for `env(safe-area-inset-*)` in the replayed CSS —
+   * the replay iframe evaluates env() to 0, which would collapse the
+   * app's own status-bar/home-indicator padding and shift every recorded
+   * touch coordinate. Absent on desktop sessions and legacy captures. */
+  safeAreaInsets?: { top: number; right: number; bottom: number; left: number };
   steps: BrowserSessionStep[];
 }
 
@@ -3810,6 +3817,9 @@ async function runOne(testCase: TestCase<unknown>): Promise<RunResult> {
       ...(opts ?? {}),
       recorder: session.recorder,
     });
+    if (browser.safeAreaInsets) {
+      session.record.safeAreaInsets = browser.safeAreaInsets;
+    }
     // An attached session starts mid-page (no navigate event will fire) —
     // stamp the inherited URL so the dashboard can still label the replay.
     if (attached && session.record.initialUrl === undefined) {
@@ -3837,10 +3847,11 @@ async function runOne(testCase: TestCase<unknown>): Promise<RunResult> {
     if (existing) return existing;
     const session = newBrowserSession(start, testCase.id, "mobile");
     sessions.push(session);
-    const { mobile, attached, detach } = await openPersistentMobile({
+    const { mobile, attached, detach, safeAreaInsets } = await openPersistentMobile({
       url: app.url,
       recorder: session.recorder,
     });
+    if (safeAreaInsets) session.record.safeAreaInsets = safeAreaInsets;
     if (attached && session.record.initialUrl === undefined) {
       session.record.initialUrl = mobile.url;
     }
@@ -4124,6 +4135,9 @@ async function evalCode(
       ...(opts ?? {}),
       recorder: session.recorder,
     });
+    if (browser.safeAreaInsets) {
+      session.record.safeAreaInsets = browser.safeAreaInsets;
+    }
     if (attached && session.record.initialUrl === undefined) {
       session.record.initialUrl = browser.url;
     }
@@ -4149,10 +4163,11 @@ async function evalCode(
     if (existing) return existing;
     const session = newBrowserSession(start, "eval", "mobile");
     sessions.push(session);
-    const { mobile, attached, detach } = await openPersistentMobile({
+    const { mobile, attached, detach, safeAreaInsets } = await openPersistentMobile({
       url: app.url,
       recorder: session.recorder,
     });
+    if (safeAreaInsets) session.record.safeAreaInsets = safeAreaInsets;
     if (attached && session.record.initialUrl === undefined) {
       session.record.initialUrl = mobile.url;
     }