sootsim 0.1.296 → 0.1.298

package/dist-lib/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -7,6 +7,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -29,6 +32,83 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// detox/motion-change.cjs
+var require_motion_change = __commonJS({
+  "detox/motion-change.cjs"(exports2, module2) {
+    "use strict";
+    var MOTION_CHANGE_DEFINITION2 = Object.freeze({
+      channelThreshold: 24,
+      minimumChangePercent: 0.1
+    });
+    function measureMotionChange2(input) {
+      if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw new Error("motion change measurement requires an input object");
+      }
+      if (input.installGlobal === true) {
+        globalThis.__sootsimMeasureMotionChange = measureMotionChange2;
+        return null;
+      }
+      const definition = input.definition;
+      if (!definition || typeof definition !== "object" || !Number.isInteger(definition.channelThreshold) || definition.channelThreshold < 0 || definition.channelThreshold > 255 || !Number.isFinite(definition.minimumChangePercent) || definition.minimumChangePercent <= 0 || definition.minimumChangePercent >= 100) {
+        throw new Error(
+          "motion change definition needs a channel threshold from 0 to 255 and a minimum greater than 0% and less than 100%"
+        );
+      }
+      const label = typeof input.label === "string" && input.label.length > 0 ? input.label : "motion change";
+      let changePixels = input.changePixels;
+      let totalPixels = input.totalPixels;
+      if (input.baseline !== void 0 || input.candidate !== void 0) {
+        const baseline = input.baseline;
+        const candidate = input.candidate;
+        const width = input.width;
+        const height = input.height;
+        if (!baseline || !candidate || typeof baseline.length !== "number" || typeof candidate.length !== "number" || !Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
+          throw new Error(`${label} needs two RGBA pixel arrays and positive dimensions`);
+        }
+        totalPixels = width * height;
+        const expectedBytes = totalPixels * 4;
+        if (baseline.length !== expectedBytes || candidate.length !== expectedBytes) {
+          throw new Error(
+            `${label} pixel data has ${baseline.length}/${candidate.length} bytes; expected ${expectedBytes}`
+          );
+        }
+        changePixels = 0;
+        for (let offset = 0; offset < expectedBytes; offset += 4) {
+          if (Math.abs(baseline[offset] - candidate[offset]) > definition.channelThreshold || Math.abs(baseline[offset + 1] - candidate[offset + 1]) > definition.channelThreshold || Math.abs(baseline[offset + 2] - candidate[offset + 2]) > definition.channelThreshold || Math.abs(baseline[offset + 3] - candidate[offset + 3]) > definition.channelThreshold) {
+            changePixels++;
+          }
+        }
+      }
+      if (!Number.isInteger(totalPixels) || totalPixels <= 0) {
+        throw new Error(`${label} has no positive measured region area`);
+      }
+      if (!Number.isInteger(changePixels) || changePixels < 0 || changePixels > totalPixels) {
+        throw new Error(
+          `${label} changed pixel count ${changePixels} is outside its ${totalPixels}px measured region`
+        );
+      }
+      const changePercent = changePixels / totalPixels * 100;
+      return {
+        changePercent,
+        changePixels,
+        passedMinimum: changePercent >= definition.minimumChangePercent,
+        totalPixels
+      };
+    }
+    function measureProofMotionChange(input) {
+      return measureMotionChange2({
+        ...input,
+        definition: MOTION_CHANGE_DEFINITION2
+      });
+    }
+    module2.exports = {
+      MOTION_CHANGE_DEFINITION: MOTION_CHANGE_DEFINITION2,
+      measureMotionChange: measureMotionChange2,
+      measureProofMotionChange
+    };
+  }
+});
+
 // detox/index.ts
 var detox_exports = {};
 __export(detox_exports, {
@@ -1157,6 +1237,7 @@ var by = {
 };
 
 // detox/index.ts
+var import_motion_change = __toESM(require_motion_change(), 1);
 var BASE_URL = process.env.SOOTSIM_URL || "http://localhost:5173";
 var SCREENSHOT_DIR = process.env.SOOTSIM_SCREENSHOT_DIR || path.join(process.cwd(), "test", "detox-driver", "screenshots");
 var DETOX_PLATFORM = process.env.SOOTSIM_PLATFORM === "android" ? "android" : "ios";
@@ -1582,6 +1663,19 @@ function decodePngDataUrl(dataUrl) {
   }
   return Buffer.from(match[1], "base64");
 }
+function writeFastScreenshotFrames(namePrefix, frames) {
+  ensureScreenshotDir();
+  return frames.map((frame) => {
+    const safeName = `${namePrefix}-${frame.label}`.replace(/[^a-zA-Z0-9._-]+/g, "-");
+    const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`);
+    fs.writeFileSync(filePath, decodePngDataUrl(frame.dataUrl));
+    const { dataUrl: _dataUrl, ...metadata } = frame;
+    return {
+      ...metadata,
+      path: filePath
+    };
+  });
+}
 async function captureSootsimPngFast(opts) {
   const page = getPage();
   const dataUrl = await page.evaluate(
@@ -2142,8 +2236,221 @@ var device = {
   async setMenuAnimOverride(progress) {
     await dispatchSootsimEventInPage("sootsim:menuAnimOverride", { value: progress });
   },
-  async setBottomTabAnimOverride(value) {
-    await dispatchSootsimEventInPage("sootsim:bottomTabAnimOverride", { value });
+  // park every render clock before the interaction, detect the first changed
+  // stepped frame inside the named component, then advance exact 60fps frames
+  // to each requested offset. native extraction also chooses the first frame
+  // at or after an offset, so both sides use the same rounding convention.
+  async takeScreenshotStagesFromVisibleChangeFast(namePrefix, stages, options) {
+    const page = getPage();
+    const token = `motion-${process.pid}-${Date.now()}-${Math.random()}`;
+    await page.evaluate(import_motion_change.measureMotionChange, {
+      definition: import_motion_change.MOTION_CHANGE_DEFINITION,
+      installGlobal: true
+    });
+    const capturePromise = page.evaluate(
+      async (input) => {
+        const captureWindow = window;
+        const live = captureWindow.SootSim?.bridges?.liveComposite;
+        const lockstep = captureWindow.SootSim?.bridges?.lockstepCapture;
+        if (!live || typeof live.captureFresh !== "function") {
+          throw new Error("SootSim live composite bridge is not installed");
+        }
+        if (!lockstep || typeof lockstep.begin !== "function") {
+          throw new Error("SootSim lockstep capture bridge is not installed");
+        }
+        const registry = captureWindow.__sootsimVisibleChangeCaptures ?? (captureWindow.__sootsimVisibleChangeCaptures = {});
+        const state = {
+          cancelled: false,
+          ready: false,
+          triggerCompleted: false
+        };
+        registry[input.token] = state;
+        const measureChange = captureWindow.__sootsimMeasureMotionChange;
+        if (!measureChange) {
+          throw new Error("SootSim motion change definition is not installed");
+        }
+        const captureBitmap = async () => {
+          const { canvas } = await live.captureFresh();
+          if (!canvas) throw new Error("SootSim live composite produced no canvas");
+          return createImageBitmap(canvas);
+        };
+        const boundsFor = (bitmap) => {
+          const scale = input.rootFrame && input.rootFrame.width > 0 ? bitmap.width / input.rootFrame.width : 1;
+          return {
+            height: input.frame ? Math.max(
+              1,
+              Math.min(
+                bitmap.height,
+                Math.ceil((input.frame.y + input.frame.height) * scale)
+              ) - Math.max(0, Math.floor(input.frame.y * scale))
+            ) : bitmap.height,
+            left: input.frame ? Math.max(0, Math.floor(input.frame.x * scale)) : 0,
+            top: input.frame ? Math.max(0, Math.floor(input.frame.y * scale)) : 0,
+            width: input.frame ? Math.max(
+              1,
+              Math.min(
+                bitmap.width,
+                Math.ceil((input.frame.x + input.frame.width) * scale)
+              ) - Math.max(0, Math.floor(input.frame.x * scale))
+            ) : bitmap.width
+          };
+        };
+        const regionPixels = (bitmap) => {
+          const bounds = boundsFor(bitmap);
+          const canvas = document.createElement("canvas");
+          canvas.width = bounds.width;
+          canvas.height = bounds.height;
+          const context = canvas.getContext("2d", { willReadFrequently: true });
+          if (!context) throw new Error("SootSim motion detector needs a 2d canvas");
+          context.drawImage(
+            bitmap,
+            bounds.left,
+            bounds.top,
+            bounds.width,
+            bounds.height,
+            0,
+            0,
+            bounds.width,
+            bounds.height
+          );
+          return context.getImageData(0, 0, bounds.width, bounds.height).data;
+        };
+        const encode = (snapshot) => {
+          const canvas = document.createElement("canvas");
+          canvas.width = snapshot.bitmap.width;
+          canvas.height = snapshot.bitmap.height;
+          const context = canvas.getContext("2d");
+          if (!context) throw new Error("SootSim motion capture needs a 2d canvas");
+          context.drawImage(snapshot.bitmap, 0, 0);
+          snapshot.bitmap.close();
+          return {
+            actualMs: snapshot.actualMs,
+            dataUrl: canvas.toDataURL("image/png"),
+            label: snapshot.label,
+            offsetMs: snapshot.offsetMs,
+            frameIndex: snapshot.frameIndex,
+            virtualTimestampMs: snapshot.virtualTimestampMs
+          };
+        };
+        const controller = await lockstep.begin(60);
+        try {
+          const baselineBitmap = await captureBitmap();
+          const baseline = regionPixels(baselineBitmap);
+          baselineBitmap.close();
+          state.ready = true;
+          while (!state.triggerCompleted) {
+            if (state.cancelled) throw new Error("SootSim motion capture was cancelled");
+            await new Promise((resolve) => setTimeout(resolve, 0));
+          }
+          let visibleStart = null;
+          let detectedMeasurement = null;
+          const detectionFrameLimit = Math.ceil(input.detectionTimeoutMs * 60 / 1e3);
+          for (let frame = 0; frame < detectionFrameLimit; frame++) {
+            if (state.cancelled) throw new Error("SootSim motion capture was cancelled");
+            const receipt = await controller.stepFrame();
+            const candidateBitmap = await captureBitmap();
+            const bounds = boundsFor(candidateBitmap);
+            const measurement = measureChange({
+              baseline,
+              candidate: regionPixels(candidateBitmap),
+              definition: input.motionChangeDefinition,
+              height: bounds.height,
+              label: "SootSim visible-change detector",
+              width: bounds.width
+            });
+            candidateBitmap.close();
+            if (measurement.passedMinimum) {
+              visibleStart = receipt;
+              detectedMeasurement = measurement;
+              break;
+            }
+          }
+          if (!visibleStart || !detectedMeasurement) {
+            throw new Error(
+              `SootSim motion had no visible change before ${input.detectionTimeoutMs}ms`
+            );
+          }
+          const snapshots = [];
+          for (const stage of input.stages) {
+            if (state.cancelled) throw new Error("SootSim motion capture was cancelled");
+            const receipt = await controller.stepToOffset(visibleStart, stage.offsetMs);
+            snapshots.push({
+              actualMs: receipt.virtualTimestampMs - visibleStart.virtualTimestampMs,
+              bitmap: await captureBitmap(),
+              frameIndex: receipt.frameIndex,
+              label: stage.label,
+              offsetMs: stage.offsetMs,
+              virtualTimestampMs: receipt.virtualTimestampMs
+            });
+          }
+          return {
+            frames: snapshots.map(encode),
+            visibleChangeDetection: {
+              actualMs: visibleStart.frameIndex * 1e3 / 60,
+              changedPixelPercent: detectedMeasurement.changePercent,
+              changedPixels: detectedMeasurement.changePixels,
+              channelThreshold: input.motionChangeDefinition.channelThreshold,
+              minimumChangePercent: input.motionChangeDefinition.minimumChangePercent,
+              totalPixels: detectedMeasurement.totalPixels,
+              frameIndex: visibleStart.frameIndex,
+              virtualTimestampMs: visibleStart.virtualTimestampMs
+            }
+          };
+        } finally {
+          controller.end();
+          delete registry[input.token];
+        }
+      },
+      {
+        detectionTimeoutMs: options.detectionTimeoutMs ?? 3e3,
+        frame: options.frame ?? null,
+        motionChangeDefinition: import_motion_change.MOTION_CHANGE_DEFINITION,
+        rootFrame: options.rootFrame ?? null,
+        stages,
+        token
+      }
+    );
+    await page.waitForFunction(
+      (captureToken) => {
+        const registry = window.__sootsimVisibleChangeCaptures;
+        return registry?.[captureToken]?.ready === true;
+      },
+      token,
+      { timeout: 5e3 }
+    );
+    const triggerStartMs = Date.now();
+    let triggerCompletedMs = 0;
+    try {
+      await Promise.resolve(options.trigger());
+      triggerCompletedMs = Date.now();
+      await page.evaluate((captureToken) => {
+        const registry = window.__sootsimVisibleChangeCaptures;
+        const capture2 = registry?.[captureToken];
+        if (!capture2) throw new Error("SootSim motion capture disarmed before trigger");
+        capture2.triggerCompleted = true;
+      }, token);
+      const capture = await capturePromise;
+      return {
+        frames: writeFastScreenshotFrames(namePrefix, capture.frames),
+        triggerCompletedMs,
+        triggerStartMs,
+        visibleChangeDetection: {
+          ...capture.visibleChangeDetection,
+          frame: options.frame ?? null,
+          rootFrame: options.rootFrame ?? null
+        }
+      };
+    } catch (error) {
+      await page.evaluate((captureToken) => {
+        const registry = window.__sootsimVisibleChangeCaptures;
+        const capture = registry?.[captureToken];
+        if (capture) capture.cancelled = true;
+      }, token).catch(() => {
+      });
+      await capturePromise.catch(() => {
+      });
+      throw error;
+    }
   },
   // FAST multi-stage capture for sub-second animation diffs. each stage
   // schedules a setTimeout at its requested offsetMs and at that moment
@@ -2236,18 +2543,7 @@ var device = {
       },
       { stages, skipWarmup: options?.skipWarmup === true }
     );
-    ensureScreenshotDir();
-    return frames.map((f) => {
-      const safeName = `${namePrefix}-${f.label}`.replace(/[^a-zA-Z0-9._-]+/g, "-");
-      const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`);
-      fs.writeFileSync(filePath, decodePngDataUrl(f.dataUrl));
-      return {
-        label: f.label,
-        offsetMs: f.offsetMs,
-        actualMs: f.actualMs,
-        path: filePath
-      };
-    });
+    return writeFastScreenshotFrames(namePrefix, frames);
   },
   // batched multi-stage capture for animation diffs. all N captures happen
   // inside one page.evaluate round trip so browser-side timing controls the
@@ -2277,18 +2573,7 @@ var device = {
       },
       { stages }
     );
-    ensureScreenshotDir();
-    return frames.map((f) => {
-      const safeName = `${namePrefix}-${f.label}`.replace(/[^a-zA-Z0-9._-]+/g, "-");
-      const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`);
-      fs.writeFileSync(filePath, decodePngDataUrl(f.dataUrl));
-      return {
-        label: f.label,
-        offsetMs: f.offsetMs,
-        actualMs: f.actualMs,
-        path: filePath
-      };
-    });
+    return writeFastScreenshotFrames(namePrefix, frames);
   },
   async shake() {
   },

package/dist-lib/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/fetch-proxy-overrides.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

package/dist-lib/host/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/index.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/jump-to-source-babel.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/menu.ts
 var SOOTSIM_ENGINE_EVENT_NAME = "sootsim:engine-event";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -1518,10 +1518,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=1.0.0",
-            coverage: 0.93,
-            note: "navigator.clipboard for text + ClipboardItem for images on browsers that expose it (Chromium-based, Safari 13.4+). getImage/getImagePNG/getImageJPG read via Clipboard.read + ClipboardItem.getType and convert to base64 matching upstream's contract; setImage decodes base64 \u2192 Blob (sniffing PNG magic for MIME) and writes via Clipboard.write([new ClipboardItem(...)]). On Firefox without Clipboard.read, image methods return empty/false matching the documented absent shape.",
-            working: "getString (readText), setString (writeText), getImage / getImagePNG / getImageJPG (real ClipboardItem read \u2192 base64), setImage (real ClipboardItem write), hasString (length check), hasImage (Clipboard.read items inspection), hasURL (regex test), useClipboard hook (state + setter + fetcher)",
-            missing: "addListener/removeAllListeners (browser API has no clipboard-change event for external apps; in-page copy event isn't covered yet on this stub), Firefox image read (no Clipboard.read support)"
+            coverage: 0.85,
+            note: "native-seam only: the published Clipboard object, NativeEventEmitter wiring, and useClipboard hook run from the bundle. RNCClipboard routes text through navigator.clipboard and images through ClipboardItem where the browser exposes it.",
+            working: "published Clipboard object and two-item useClipboard hook, getString/setString/hasString, getImage/getImagePNG/getImageJPG/setImage/hasImage, hasURL/hasWebURL/hasNumber, load-safe listener methods",
+            missing: "external-app clipboard-change events because browsers expose no matching event; setStrings joins values and getStrings returns one browser text item rather than preserving multiple pasteboard strings; Firefox image read because Clipboard.read is unavailable"
           }
         ]
       },
@@ -3881,9 +3881,9 @@ var init_registry = __esm({
           {
             range: ">=0.30.0",
             coverage: 0.3,
-            note: "proxy framework \u2014 modules using nitro keep loading, but no native bindings actually run",
-            working: "NitroModules.createHybridObject returns chainable proxy (no crash), getHostObject returns same proxy, HybridObject type export, proxy toString/toPrimitive",
-            missing: "NitroModules.hasHybridObject always false, all real native JSI bindings (every call is a noop proxy \u2014 no actual native module functionality)"
+            note: "native-seam only: the published Nitro Modules entrypoint installs a load-safe framework proxy, but no native JSI bindings run",
+            working: "published entrypoint and type exports, NitroModules metadata, createHybridObject chainable proxy, hasHybridObject/getAllHybridObjectNames unavailable state, isRuntimeAlive false, callback wrapper, getHybridObjectConstructor",
+            missing: "the native JSI framework implementation; package-specific HybridObjects work only where a separate compat seam registers them, and native memory accounting, ArrayBuffer ownership, cross-runtime boxed HybridObjects, and Nitro Views remain absent"
           }
         ]
       },
@@ -4174,10 +4174,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=2.0.0",
-            coverage: 0.9,
+            coverage: 0.85,
             note: "pure JS WHATWG URL/URLSearchParams polyfill; NativeModules.BlobModule access is guarded",
             working: "URL, URLSearchParams, setupURLPolyfill, auto.js web guard, canParse, global URL/URLSearchParams installation",
-            missing: "React Native BlobModule-specific createObjectURL path is absent when BlobModule is unavailable; browser Blob URLs should use the native URL implementation"
+            missing: "URLSearchParams.sort does not reorder keys in the published 3.0.0 dependency; React Native BlobModule-specific createObjectURL is absent when BlobModule is unavailable, so browser Blob URLs should use the native URL implementation"
           }
         ]
       },
@@ -4555,7 +4555,7 @@ var init_registry = __esm({
             range: ">=3.0.0",
             coverage: 0.95,
             note: "pure JS React error boundary with RN fallback UI",
-            working: "ErrorBoundary component, FallbackComponent/fallbackRender/FallbackComponent prop paths, onError/onReset, resetKeys, useErrorBoundary",
+            working: "ErrorBoundary component, bundled fallback UI, custom FallbackComponent, onError callback, resetError recovery",
             missing: "fallback rendering fidelity follows core RN View/Text/Button primitives"
           }
         ]
@@ -10713,6 +10713,7 @@ __export(bridge_constants_exports, {
   DEFAULT_SOOTSIM_BRIDGE_URL: () => DEFAULT_SOOTSIM_BRIDGE_URL,
   SOOTSIM_BRIDGE_SIM_CLOSE_CODE: () => SOOTSIM_BRIDGE_SIM_CLOSE_CODE,
   SOOTSIM_BRIDGE_SIM_CLOSE_REASON: () => SOOTSIM_BRIDGE_SIM_CLOSE_REASON,
+  isSootsimBridgeHealth: () => isSootsimBridgeHealth,
   resolveSootsimBridgePort: () => resolveSootsimBridgePort,
   resolveSootsimBridgePortForHttpPort: () => resolveSootsimBridgePortForHttpPort,
   resolveSootsimBridgePortForRuntimeLocation: () => resolveSootsimBridgePortForRuntimeLocation,
@@ -10809,6 +10810,9 @@ function resolveSootsimBridgeWebSocketUrl(input) {
     href: input.href
   });
 }
+function isSootsimBridgeHealth(value, expectedPort) {
+  return typeof value === "object" && value !== null && Reflect.get(value, "ok") === true && Reflect.get(value, "bridgePort") === expectedPort;
+}
 var DEFAULT_SOOTSIM_BRIDGE_PORT, DEFAULT_SOOTSIM_BRIDGE_URL, CONTRAST_DEV_HTTP_BASE_PORT, SOOTSIM_SITE_DEV_HTTP_BASE_PORT, SOOTSIM_SHELL_DEV_HTTP_BASE_PORT, LOCAL_DEV_HTTP_BASE_PORTS, MAX_LOCAL_DEV_PORT_OFFSET, SOOTSIM_BRIDGE_SIM_CLOSE_CODE, SOOTSIM_BRIDGE_SIM_CLOSE_REASON;
 var init_bridge_constants = __esm({
   "src/bridge-constants.ts"() {

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sootsim",
-  "version": "0.1.296",
+  "version": "0.1.298",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",

package/src/bridge-constants.ts

@@ -140,6 +140,15 @@ export function resolveSootsimBridgeWebSocketUrl(input: {
   })
 }
 
+export function isSootsimBridgeHealth(value: unknown, expectedPort: number): boolean {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    Reflect.get(value, 'ok') === true &&
+    Reflect.get(value, 'bridgePort') === expectedPort
+  )
+}
+
 // private websocket close code used when the daemon intentionally closes a
 // sim. browser clients treat it as terminal and skip their normal reconnect
 // loop; playwright-owned sims use it to close their hosting context.