sootsim 0.1.239 → 0.1.241

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.239 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.241 | (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;
@@ -76,6 +76,7 @@ __export(sdk_exports, {
   resolveFindMode: () => resolveFindMode,
   resolveMaxMsFlag: () => resolveMaxMsFlag,
   scoreInteractive: () => scoreInteractive,
+  scoreLayoutTextContrast: () => scoreLayoutTextContrast,
   setDebugChannels: () => setDebugChannels,
   shouldSkipAutoSettleForInspectPick: () => shouldSkipAutoSettleForInspectPick,
   tapBest: () => tapBest,
@@ -236,6 +237,101 @@ async function inspectDescribe(bridge, dumpOpts) {
   const result = await bridge.send({ type: "evaluate", code });
   return result ?? {};
 }
+function scoreLayoutTextContrast(input) {
+  const required = input.fontSize >= 18 || input.fontSize >= 14 && (input.fontWeight ?? 400) >= 700 ? 3 : 4.5;
+  const { normal, background } = input;
+  if (normal.width <= 0 || normal.height <= 0 || normal.width !== background.width || normal.height !== background.height) {
+    return { ratio: null, required, reason: "capture dimensions do not match" };
+  }
+  const left = Math.max(0, Math.floor(input.box.x));
+  const top = Math.max(0, Math.floor(input.box.y));
+  const right = Math.min(normal.width, Math.ceil(input.box.x + input.box.w));
+  const bottom = Math.min(normal.height, Math.ceil(input.box.y + input.box.h));
+  if (right <= left || bottom <= top) {
+    return { ratio: null, required, reason: "text is outside the captured frame" };
+  }
+  const linear = (value) => {
+    const channel = value / 255;
+    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);
+  };
+  const ratioOf = (foreground, behind) => {
+    const foregroundLuminance = 0.2126 * linear(foreground[0]) + 0.7152 * linear(foreground[1]) + 0.0722 * linear(foreground[2]);
+    const backgroundLuminance = 0.2126 * linear(behind[0]) + 0.7152 * linear(behind[1]) + 0.0722 * linear(behind[2]);
+    return (Math.max(foregroundLuminance, backgroundLuminance) + 0.05) / (Math.min(foregroundLuminance, backgroundLuminance) + 0.05);
+  };
+  const hex = (color) => `#${color.slice(0, 3).map((value) => Math.round(value).toString(16).padStart(2, "0")).join("")}`;
+  const area = (right - left) * (bottom - top);
+  const step = Math.max(1, Math.floor(Math.sqrt(area / 12e3)));
+  const offsetAt = (x, y) => (y * normal.width + x) * 4;
+  const deltaAt = (offset) => Math.max(
+    Math.abs(normal.data[offset] - background.data[offset]),
+    Math.abs(normal.data[offset + 1] - background.data[offset + 1]),
+    Math.abs(normal.data[offset + 2] - background.data[offset + 2])
+  );
+  let strongestDelta = 0;
+  let strongestForeground = null;
+  let opaqueBackground = null;
+  for (let y = top; y < bottom; y += step) {
+    for (let x = left; x < right; x += step) {
+      const offset = offsetAt(x, y);
+      if (background.data[offset + 3] < 250) continue;
+      const behind = [
+        background.data[offset],
+        background.data[offset + 1],
+        background.data[offset + 2]
+      ];
+      opaqueBackground ??= behind;
+      const delta = deltaAt(offset);
+      if (delta <= strongestDelta) continue;
+      strongestDelta = delta;
+      strongestForeground = [
+        normal.data[offset],
+        normal.data[offset + 1],
+        normal.data[offset + 2]
+      ];
+    }
+  }
+  let bestRatio = Infinity;
+  let bestForeground = null;
+  let bestBackground = null;
+  const consider = (foreground, behind) => {
+    const ratio = ratioOf(foreground, behind);
+    if (ratio >= bestRatio) return;
+    bestRatio = ratio;
+    bestForeground = foreground;
+    bestBackground = behind;
+  };
+  if (strongestDelta >= 2 && strongestForeground) {
+    for (let y = top; y < bottom; y += step) {
+      for (let x = left; x < right; x += step) {
+        const offset = offsetAt(x, y);
+        if (background.data[offset + 3] < 250 || deltaAt(offset) < 2) {
+          continue;
+        }
+        consider(strongestForeground, [
+          background.data[offset],
+          background.data[offset + 1],
+          background.data[offset + 2]
+        ]);
+      }
+    }
+  } else if (opaqueBackground) {
+    consider(opaqueBackground, opaqueBackground);
+  }
+  if (!bestForeground || !bestBackground || !Number.isFinite(bestRatio)) {
+    return {
+      ratio: null,
+      required,
+      reason: "could not isolate opaque rendered text pixels"
+    };
+  }
+  return {
+    ratio: Math.round(bestRatio * 100) / 100,
+    required,
+    foreground: hex(bestForeground),
+    background: hex(bestBackground)
+  };
+}
 function layoutGetNativeEval(opts = {}) {
   const includeStyle = opts.styling === true;
   const filter = opts.filter?.trim().toLowerCase() ?? "";
@@ -245,6 +341,7 @@ function layoutGetNativeEval(opts = {}) {
       const list = await t.listInspectable({})
       if (!Array.isArray(list)) return []
       const includeStyle = ${JSON.stringify(includeStyle)}
+      const scoreContrast = ${scoreLayoutTextContrast.toString()}
       // narrows by ELEMENT, not by style field: fewer rows, full detail on each.
       const filter = ${JSON.stringify(filter)}
       const matchesFilter = (n, text) => {
@@ -289,7 +386,7 @@ function layoutGetNativeEval(opts = {}) {
       }
       const weightOf = (style) => {
         const w = style && style.fontWeight
-        const n = typeof w === 'number' ? w : (typeof w === 'string' ? parseInt(w, 10) : NaN)
+        const n = w === 'bold' ? 700 : (typeof w === 'number' ? w : (typeof w === 'string' ? parseInt(w, 10) : NaN))
         return Number.isFinite(n) && n >= 600 ? n : undefined
       }
       const decoOf = (style) => {
@@ -332,7 +429,7 @@ function layoutGetNativeEval(opts = {}) {
         return abs.x + layout.width > 0 && abs.y + layout.height > 0 && abs.x < screenW && abs.y < screenH
       }
 
-      return list.filter(isVisible).filter((n) => {
+      const elements = list.filter(isVisible).filter((n) => {
         const t = typeof n.text === 'string' && n.text.trim() ? n.text.trim() : undefined
         return matchesFilter(n, t)
       }).map((n) => {
@@ -367,7 +464,7 @@ function layoutGetNativeEval(opts = {}) {
           ...base,
           borderRadius: radiusOf(style),
           padding: { t: round(pad.top), r: round(pad.right), b: round(pad.bottom), l: round(pad.left) },
-          fontSize: fontSizeOf(style),
+          fontSize: text ? (fontSizeOf(style) || 14) : 0,
           color: text ? colorStr(style.color) : undefined,
           bg: colorStr(style.backgroundColor),
           opacity: opacityOf(style),
@@ -378,6 +475,50 @@ function layoutGetNativeEval(opts = {}) {
           borderColor: borderWidth ? borderColorOf(style) : undefined,
         }
       })
+      const textElements = elements.filter((element) => element.text && element.fontSize > 0)
+      if (!includeStyle || textElements.length === 0) return elements
+
+      const screenshot = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.screenshot
+      if (typeof screenshot !== 'function') {
+        throw new Error('styled native layout requires the SootSim capture bridge')
+      }
+      const device = list.find((node) => node && node.device)?.device || {}
+      const width = Math.round(Number(device.width) || window.innerWidth || 0)
+      const height = Math.round(Number(device.height) || window.innerHeight || 0)
+      if (!width || !height) throw new Error('native layout has no capture dimensions')
+      const capture = async (suppressText) => {
+        const dataUrl = await screenshot({
+          format: 'png',
+          outputWidth: width,
+          outputHeight: height,
+          ...(suppressText ? { suppressText: true } : {}),
+        })
+        const image = await new Promise((resolve, reject) => {
+          const next = new Image()
+          next.onload = () => resolve(next)
+          next.onerror = () => reject(new Error('could not decode native layout pixels'))
+          next.src = dataUrl
+        })
+        const canvas = document.createElement('canvas')
+        canvas.width = image.naturalWidth
+        canvas.height = image.naturalHeight
+        const context = canvas.getContext('2d', { willReadFrequently: true })
+        if (!context) throw new Error('could not read native layout pixels')
+        context.drawImage(image, 0, 0)
+        return context.getImageData(0, 0, canvas.width, canvas.height)
+      }
+      const normal = await capture(false)
+      const background = await capture(true)
+      for (const element of textElements) {
+        element.contrast = scoreContrast({
+          normal,
+          background,
+          box: element.box,
+          fontSize: element.fontSize,
+          fontWeight: element.fontWeight,
+        })
+      }
+      return elements
     })()`;
 }
 var LAYOUT_GET_NATIVE_EVAL = layoutGetNativeEval();
@@ -404,6 +545,11 @@ function formatLayoutElements(elements, opts) {
       if (el.fontWeight) parts.push(`weight:${el.fontWeight}`);
       if (el.color) parts.push(`color:${el.color}`);
       if (el.bg) parts.push(`bg:${el.bg}`);
+      if (el.contrast) {
+        const score = el.contrast.ratio == null ? `?/${el.contrast.required}` : `${el.contrast.ratio}/${el.contrast.required}${el.contrast.ratio < el.contrast.required ? " FAIL" : ""}`;
+        parts.push(`contrast:${score}`);
+        if (el.contrast.background) parts.push(`on:${el.contrast.background}`);
+      }
       if (el.opacity != null) parts.push(`opacity:${el.opacity}`);
       if (el.textDecoration) parts.push(`deco:${el.textDecoration}`);
       if (el.overflow) parts.push(`overflow:${el.overflow}`);
@@ -1204,6 +1350,10 @@ async function inspectScreens(bridge) {
         test && typeof test.getNavigationSnapshot === 'function'
           ? await test.getNavigationSnapshot()
           : null
+      const route =
+        test && typeof test.getRouteInfo === 'function'
+          ? await test.getRouteInfo()
+          : null
       const keyboard =
         kb && typeof kb.getLayout === 'function'
           ? (() => {
@@ -1220,13 +1370,14 @@ async function inspectScreens(bridge) {
               } : null
             })()
           : null
-      return { nav: navSnap, keyboard }
+      return { nav: navSnap, route, keyboard }
     })()`
   });
   const shell = await getShellState(bridge, 500).catch(() => null);
   return {
     shell,
     nav: payload?.nav ?? null,
+    route: payload?.route ?? null,
     keyboard: payload?.keyboard ?? null
   };
 }
@@ -2084,6 +2235,7 @@ async function tapBest(bridge, query, opts = {}) {
   resolveFindMode,
   resolveMaxMsFlag,
   scoreInteractive,
+  scoreLayoutTextContrast,
   setDebugChannels,
   shouldSkipAutoSettleForInspectPick,
   tapBest,

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.239 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.241 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {
@@ -146,6 +146,101 @@ async function inspectDescribe(bridge, dumpOpts) {
   const result = await bridge.send({ type: "evaluate", code });
   return result ?? {};
 }
+function scoreLayoutTextContrast(input) {
+  const required = input.fontSize >= 18 || input.fontSize >= 14 && (input.fontWeight ?? 400) >= 700 ? 3 : 4.5;
+  const { normal, background } = input;
+  if (normal.width <= 0 || normal.height <= 0 || normal.width !== background.width || normal.height !== background.height) {
+    return { ratio: null, required, reason: "capture dimensions do not match" };
+  }
+  const left = Math.max(0, Math.floor(input.box.x));
+  const top = Math.max(0, Math.floor(input.box.y));
+  const right = Math.min(normal.width, Math.ceil(input.box.x + input.box.w));
+  const bottom = Math.min(normal.height, Math.ceil(input.box.y + input.box.h));
+  if (right <= left || bottom <= top) {
+    return { ratio: null, required, reason: "text is outside the captured frame" };
+  }
+  const linear = (value) => {
+    const channel = value / 255;
+    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);
+  };
+  const ratioOf = (foreground, behind) => {
+    const foregroundLuminance = 0.2126 * linear(foreground[0]) + 0.7152 * linear(foreground[1]) + 0.0722 * linear(foreground[2]);
+    const backgroundLuminance = 0.2126 * linear(behind[0]) + 0.7152 * linear(behind[1]) + 0.0722 * linear(behind[2]);
+    return (Math.max(foregroundLuminance, backgroundLuminance) + 0.05) / (Math.min(foregroundLuminance, backgroundLuminance) + 0.05);
+  };
+  const hex = (color) => `#${color.slice(0, 3).map((value) => Math.round(value).toString(16).padStart(2, "0")).join("")}`;
+  const area = (right - left) * (bottom - top);
+  const step = Math.max(1, Math.floor(Math.sqrt(area / 12e3)));
+  const offsetAt = (x, y) => (y * normal.width + x) * 4;
+  const deltaAt = (offset) => Math.max(
+    Math.abs(normal.data[offset] - background.data[offset]),
+    Math.abs(normal.data[offset + 1] - background.data[offset + 1]),
+    Math.abs(normal.data[offset + 2] - background.data[offset + 2])
+  );
+  let strongestDelta = 0;
+  let strongestForeground = null;
+  let opaqueBackground = null;
+  for (let y = top; y < bottom; y += step) {
+    for (let x = left; x < right; x += step) {
+      const offset = offsetAt(x, y);
+      if (background.data[offset + 3] < 250) continue;
+      const behind = [
+        background.data[offset],
+        background.data[offset + 1],
+        background.data[offset + 2]
+      ];
+      opaqueBackground ?? (opaqueBackground = behind);
+      const delta = deltaAt(offset);
+      if (delta <= strongestDelta) continue;
+      strongestDelta = delta;
+      strongestForeground = [
+        normal.data[offset],
+        normal.data[offset + 1],
+        normal.data[offset + 2]
+      ];
+    }
+  }
+  let bestRatio = Infinity;
+  let bestForeground = null;
+  let bestBackground = null;
+  const consider = (foreground, behind) => {
+    const ratio = ratioOf(foreground, behind);
+    if (ratio >= bestRatio) return;
+    bestRatio = ratio;
+    bestForeground = foreground;
+    bestBackground = behind;
+  };
+  if (strongestDelta >= 2 && strongestForeground) {
+    for (let y = top; y < bottom; y += step) {
+      for (let x = left; x < right; x += step) {
+        const offset = offsetAt(x, y);
+        if (background.data[offset + 3] < 250 || deltaAt(offset) < 2) {
+          continue;
+        }
+        consider(strongestForeground, [
+          background.data[offset],
+          background.data[offset + 1],
+          background.data[offset + 2]
+        ]);
+      }
+    }
+  } else if (opaqueBackground) {
+    consider(opaqueBackground, opaqueBackground);
+  }
+  if (!bestForeground || !bestBackground || !Number.isFinite(bestRatio)) {
+    return {
+      ratio: null,
+      required,
+      reason: "could not isolate opaque rendered text pixels"
+    };
+  }
+  return {
+    ratio: Math.round(bestRatio * 100) / 100,
+    required,
+    foreground: hex(bestForeground),
+    background: hex(bestBackground)
+  };
+}
 function layoutGetNativeEval(opts = {}) {
   const includeStyle = opts.styling === true;
   const filter = opts.filter?.trim().toLowerCase() ?? "";
@@ -155,6 +250,7 @@ function layoutGetNativeEval(opts = {}) {
       const list = await t.listInspectable({})
       if (!Array.isArray(list)) return []
       const includeStyle = ${JSON.stringify(includeStyle)}
+      const scoreContrast = ${scoreLayoutTextContrast.toString()}
       // narrows by ELEMENT, not by style field: fewer rows, full detail on each.
       const filter = ${JSON.stringify(filter)}
       const matchesFilter = (n, text) => {
@@ -199,7 +295,7 @@ function layoutGetNativeEval(opts = {}) {
       }
       const weightOf = (style) => {
         const w = style && style.fontWeight
-        const n = typeof w === 'number' ? w : (typeof w === 'string' ? parseInt(w, 10) : NaN)
+        const n = w === 'bold' ? 700 : (typeof w === 'number' ? w : (typeof w === 'string' ? parseInt(w, 10) : NaN))
         return Number.isFinite(n) && n >= 600 ? n : undefined
       }
       const decoOf = (style) => {
@@ -242,7 +338,7 @@ function layoutGetNativeEval(opts = {}) {
         return abs.x + layout.width > 0 && abs.y + layout.height > 0 && abs.x < screenW && abs.y < screenH
       }
 
-      return list.filter(isVisible).filter((n) => {
+      const elements = list.filter(isVisible).filter((n) => {
         const t = typeof n.text === 'string' && n.text.trim() ? n.text.trim() : undefined
         return matchesFilter(n, t)
       }).map((n) => {
@@ -277,7 +373,7 @@ function layoutGetNativeEval(opts = {}) {
           ...base,
           borderRadius: radiusOf(style),
           padding: { t: round(pad.top), r: round(pad.right), b: round(pad.bottom), l: round(pad.left) },
-          fontSize: fontSizeOf(style),
+          fontSize: text ? (fontSizeOf(style) || 14) : 0,
           color: text ? colorStr(style.color) : undefined,
           bg: colorStr(style.backgroundColor),
           opacity: opacityOf(style),
@@ -288,6 +384,50 @@ function layoutGetNativeEval(opts = {}) {
           borderColor: borderWidth ? borderColorOf(style) : undefined,
         }
       })
+      const textElements = elements.filter((element) => element.text && element.fontSize > 0)
+      if (!includeStyle || textElements.length === 0) return elements
+
+      const screenshot = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.screenshot
+      if (typeof screenshot !== 'function') {
+        throw new Error('styled native layout requires the SootSim capture bridge')
+      }
+      const device = list.find((node) => node && node.device)?.device || {}
+      const width = Math.round(Number(device.width) || window.innerWidth || 0)
+      const height = Math.round(Number(device.height) || window.innerHeight || 0)
+      if (!width || !height) throw new Error('native layout has no capture dimensions')
+      const capture = async (suppressText) => {
+        const dataUrl = await screenshot({
+          format: 'png',
+          outputWidth: width,
+          outputHeight: height,
+          ...(suppressText ? { suppressText: true } : {}),
+        })
+        const image = await new Promise((resolve, reject) => {
+          const next = new Image()
+          next.onload = () => resolve(next)
+          next.onerror = () => reject(new Error('could not decode native layout pixels'))
+          next.src = dataUrl
+        })
+        const canvas = document.createElement('canvas')
+        canvas.width = image.naturalWidth
+        canvas.height = image.naturalHeight
+        const context = canvas.getContext('2d', { willReadFrequently: true })
+        if (!context) throw new Error('could not read native layout pixels')
+        context.drawImage(image, 0, 0)
+        return context.getImageData(0, 0, canvas.width, canvas.height)
+      }
+      const normal = await capture(false)
+      const background = await capture(true)
+      for (const element of textElements) {
+        element.contrast = scoreContrast({
+          normal,
+          background,
+          box: element.box,
+          fontSize: element.fontSize,
+          fontWeight: element.fontWeight,
+        })
+      }
+      return elements
     })()`;
 }
 var LAYOUT_GET_NATIVE_EVAL = layoutGetNativeEval();
@@ -314,6 +454,11 @@ function formatLayoutElements(elements, opts) {
       if (el.fontWeight) parts.push(`weight:${el.fontWeight}`);
       if (el.color) parts.push(`color:${el.color}`);
       if (el.bg) parts.push(`bg:${el.bg}`);
+      if (el.contrast) {
+        const score = el.contrast.ratio == null ? `?/${el.contrast.required}` : `${el.contrast.ratio}/${el.contrast.required}${el.contrast.ratio < el.contrast.required ? " FAIL" : ""}`;
+        parts.push(`contrast:${score}`);
+        if (el.contrast.background) parts.push(`on:${el.contrast.background}`);
+      }
       if (el.opacity != null) parts.push(`opacity:${el.opacity}`);
       if (el.textDecoration) parts.push(`deco:${el.textDecoration}`);
       if (el.overflow) parts.push(`overflow:${el.overflow}`);
@@ -1114,6 +1259,10 @@ async function inspectScreens(bridge) {
         test && typeof test.getNavigationSnapshot === 'function'
           ? await test.getNavigationSnapshot()
           : null
+      const route =
+        test && typeof test.getRouteInfo === 'function'
+          ? await test.getRouteInfo()
+          : null
       const keyboard =
         kb && typeof kb.getLayout === 'function'
           ? (() => {
@@ -1130,13 +1279,14 @@ async function inspectScreens(bridge) {
               } : null
             })()
           : null
-      return { nav: navSnap, keyboard }
+      return { nav: navSnap, route, keyboard }
     })()`
   });
   const shell = await getShellState(bridge, 500).catch(() => null);
   return {
     shell,
     nav: payload?.nav ?? null,
+    route: payload?.route ?? null,
     keyboard: payload?.keyboard ?? null
   };
 }
@@ -1993,6 +2143,7 @@ export {
   resolveFindMode,
   resolveMaxMsFlag,
   scoreInteractive,
+  scoreLayoutTextContrast,
   setDebugChannels,
   shouldSkipAutoSettleForInspectPick,
   tapBest,