rnxsim 0.1.542 → 0.1.544

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/beta.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/beta.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/bridge-contract-input.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/bridge-contract-input.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_MAX_MS = 5e3;

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/bridge-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var REFUSED_PERFORM_STEP_TYPES = [

package/dist-lib/capture-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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;
@@ -25,6 +25,7 @@ __export(capture_contract_exports, {
   RNX_SCREEN_CAPTURE_VERSION: () => RNX_SCREEN_CAPTURE_VERSION,
   isRnxCaptureRegionAtlas: () => isRnxCaptureRegionAtlas,
   isRnxScreenCapture: () => isRnxScreenCapture,
+  packRnxCaptureRegions: () => packRnxCaptureRegions,
   rnxCaptureRasterRegions: () => rnxCaptureRasterRegions,
   rnxRasterFrames: () => rnxRasterFrames,
   selectRnxRasterNodeIds: () => selectRnxRasterNodeIds
@@ -138,6 +139,95 @@ function rnxCaptureRasterRegions(capture) {
     return frame ? [{ key: String(nodeId), nodeId, frame }] : [];
   });
 }
+function packRnxCaptureRegions(regions, pixelRatio, surface) {
+  const physical = regions.map((region) => {
+    const left = Math.floor(region.frame.x * pixelRatio);
+    const top = Math.floor(region.frame.y * pixelRatio);
+    const right = Math.ceil((region.frame.x + region.frame.width) * pixelRatio);
+    const bottom = Math.ceil((region.frame.y + region.frame.height) * pixelRatio);
+    if (left < 0 || top < 0 || right > surface.pixelWidth || bottom > surface.pixelHeight || right <= left || bottom <= top) {
+      throw new Error(`capture region ${region.key} is outside the app surface`);
+    }
+    return {
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: {
+        x: left / pixelRatio,
+        y: top / pixelRatio,
+        width: (right - left) / pixelRatio,
+        height: (bottom - top) / pixelRatio
+      },
+      sourceX: left,
+      sourceY: top,
+      pixelWidth: right - left,
+      pixelHeight: bottom - top
+    };
+  });
+  const largestWidth = Math.max(...physical.map((region) => region.pixelWidth));
+  const totalArea = physical.reduce(
+    (area, region) => area + region.pixelWidth * region.pixelHeight,
+    0
+  );
+  if (totalArea > 4194304) {
+    throw new Error("capture region pixels exceed the atlas budget");
+  }
+  const candidates = [
+    largestWidth,
+    Math.max(largestWidth, Math.ceil(Math.sqrt(totalArea))),
+    Math.max(largestWidth, surface.pixelWidth),
+    4096
+  ];
+  const ordered = [...physical].sort(
+    (left, right) => right.pixelHeight - left.pixelHeight || right.pixelWidth - left.pixelWidth || left.key.localeCompare(right.key)
+  );
+  let best = null;
+  for (const candidate of [...new Set(candidates)]) {
+    if (candidate > 4096) continue;
+    let x = 0;
+    let y = 0;
+    let rowHeight = 0;
+    let usedWidth = 0;
+    const packed = [];
+    for (const region of ordered) {
+      if (x > 0 && x + region.pixelWidth > candidate) {
+        y += rowHeight;
+        x = 0;
+        rowHeight = 0;
+      }
+      packed.push({ ...region, atlasX: x, atlasY: y });
+      x += region.pixelWidth;
+      rowHeight = Math.max(rowHeight, region.pixelHeight);
+      usedWidth = Math.max(usedWidth, x);
+    }
+    const height2 = y + rowHeight;
+    if (height2 > 4096 || usedWidth * height2 > 4194304) continue;
+    const result = { width: usedWidth, height: height2, regions: packed };
+    if (!best || result.width * result.height < best.width * best.height) best = result;
+  }
+  if (!best) throw new Error("capture regions cannot fit in one bounded atlas");
+  const width = best.width / pixelRatio;
+  const height = best.height / pixelRatio;
+  return {
+    width,
+    height,
+    pixelWidth: best.width,
+    pixelHeight: best.height,
+    regions: best.regions,
+    atlasRegions: best.regions.map((region) => ({
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: region.frame,
+      // a region flush with the far edge is anchored to the logical edge so
+      // its source never runs past the atlas by a rounding hair
+      source: {
+        x: region.atlasX + region.pixelWidth === best.width ? width - region.frame.width : region.atlasX / pixelRatio,
+        y: region.atlasY + region.pixelHeight === best.height ? height - region.frame.height : region.atlasY / pixelRatio,
+        width: region.frame.width,
+        height: region.frame.height
+      }
+    }))
+  };
+}
 function captureRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -193,7 +283,7 @@ function isRnxScreenCapture(value) {
   return captureRecord(tree.viewport) && captureInteger(tree.viewport.width) && tree.viewport.width > 0 && captureInteger(tree.viewport.height) && tree.viewport.height > 0 && captureInteger(tree.rootNodeId) && (tree.commitRevision === void 0 || captureInteger(tree.commitRevision)) && Array.isArray(tree.nodes) && tree.nodes.every(captureNode) && (visual === void 0 || visual.kind === "png" && (visual.producer === "headless-cpu-app-surface" || visual.producer === "browser-compositor-app-surface") && typeof visual.dataUri === "string" && visual.dataUri.startsWith("data:image/png;base64,") && captureInteger(visual.pixelWidth) && visual.pixelWidth > 0 && captureInteger(visual.pixelHeight) && visual.pixelHeight > 0);
 }
 function isRnxCaptureRegionAtlas(value) {
-  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
+  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" && value.producer !== "browser-compositor-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
     return false;
   }
   const scale = value.pixelWidth / value.width;
@@ -214,6 +304,7 @@ function isRnxCaptureRegionAtlas(value) {
   RNX_SCREEN_CAPTURE_VERSION,
   isRnxCaptureRegionAtlas,
   isRnxScreenCapture,
+  packRnxCaptureRegions,
   rnxCaptureRasterRegions,
   rnxRasterFrames,
   selectRnxRasterNodeIds

package/dist-lib/capture-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/capture-contract.ts
 var RNX_SCREEN_CAPTURE_VERSION = 1;
@@ -109,6 +109,95 @@ function rnxCaptureRasterRegions(capture) {
     return frame ? [{ key: String(nodeId), nodeId, frame }] : [];
   });
 }
+function packRnxCaptureRegions(regions, pixelRatio, surface) {
+  const physical = regions.map((region) => {
+    const left = Math.floor(region.frame.x * pixelRatio);
+    const top = Math.floor(region.frame.y * pixelRatio);
+    const right = Math.ceil((region.frame.x + region.frame.width) * pixelRatio);
+    const bottom = Math.ceil((region.frame.y + region.frame.height) * pixelRatio);
+    if (left < 0 || top < 0 || right > surface.pixelWidth || bottom > surface.pixelHeight || right <= left || bottom <= top) {
+      throw new Error(`capture region ${region.key} is outside the app surface`);
+    }
+    return {
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: {
+        x: left / pixelRatio,
+        y: top / pixelRatio,
+        width: (right - left) / pixelRatio,
+        height: (bottom - top) / pixelRatio
+      },
+      sourceX: left,
+      sourceY: top,
+      pixelWidth: right - left,
+      pixelHeight: bottom - top
+    };
+  });
+  const largestWidth = Math.max(...physical.map((region) => region.pixelWidth));
+  const totalArea = physical.reduce(
+    (area, region) => area + region.pixelWidth * region.pixelHeight,
+    0
+  );
+  if (totalArea > 4194304) {
+    throw new Error("capture region pixels exceed the atlas budget");
+  }
+  const candidates = [
+    largestWidth,
+    Math.max(largestWidth, Math.ceil(Math.sqrt(totalArea))),
+    Math.max(largestWidth, surface.pixelWidth),
+    4096
+  ];
+  const ordered = [...physical].sort(
+    (left, right) => right.pixelHeight - left.pixelHeight || right.pixelWidth - left.pixelWidth || left.key.localeCompare(right.key)
+  );
+  let best = null;
+  for (const candidate of [...new Set(candidates)]) {
+    if (candidate > 4096) continue;
+    let x = 0;
+    let y = 0;
+    let rowHeight = 0;
+    let usedWidth = 0;
+    const packed = [];
+    for (const region of ordered) {
+      if (x > 0 && x + region.pixelWidth > candidate) {
+        y += rowHeight;
+        x = 0;
+        rowHeight = 0;
+      }
+      packed.push({ ...region, atlasX: x, atlasY: y });
+      x += region.pixelWidth;
+      rowHeight = Math.max(rowHeight, region.pixelHeight);
+      usedWidth = Math.max(usedWidth, x);
+    }
+    const height2 = y + rowHeight;
+    if (height2 > 4096 || usedWidth * height2 > 4194304) continue;
+    const result = { width: usedWidth, height: height2, regions: packed };
+    if (!best || result.width * result.height < best.width * best.height) best = result;
+  }
+  if (!best) throw new Error("capture regions cannot fit in one bounded atlas");
+  const width = best.width / pixelRatio;
+  const height = best.height / pixelRatio;
+  return {
+    width,
+    height,
+    pixelWidth: best.width,
+    pixelHeight: best.height,
+    regions: best.regions,
+    atlasRegions: best.regions.map((region) => ({
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: region.frame,
+      // a region flush with the far edge is anchored to the logical edge so
+      // its source never runs past the atlas by a rounding hair
+      source: {
+        x: region.atlasX + region.pixelWidth === best.width ? width - region.frame.width : region.atlasX / pixelRatio,
+        y: region.atlasY + region.pixelHeight === best.height ? height - region.frame.height : region.atlasY / pixelRatio,
+        width: region.frame.width,
+        height: region.frame.height
+      }
+    }))
+  };
+}
 function captureRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -164,7 +253,7 @@ function isRnxScreenCapture(value) {
   return captureRecord(tree.viewport) && captureInteger(tree.viewport.width) && tree.viewport.width > 0 && captureInteger(tree.viewport.height) && tree.viewport.height > 0 && captureInteger(tree.rootNodeId) && (tree.commitRevision === void 0 || captureInteger(tree.commitRevision)) && Array.isArray(tree.nodes) && tree.nodes.every(captureNode) && (visual === void 0 || visual.kind === "png" && (visual.producer === "headless-cpu-app-surface" || visual.producer === "browser-compositor-app-surface") && typeof visual.dataUri === "string" && visual.dataUri.startsWith("data:image/png;base64,") && captureInteger(visual.pixelWidth) && visual.pixelWidth > 0 && captureInteger(visual.pixelHeight) && visual.pixelHeight > 0);
 }
 function isRnxCaptureRegionAtlas(value) {
-  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
+  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" && value.producer !== "browser-compositor-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
     return false;
   }
   const scale = value.pixelWidth / value.width;
@@ -184,6 +273,7 @@ export {
   RNX_SCREEN_CAPTURE_VERSION,
   isRnxCaptureRegionAtlas,
   isRnxScreenCapture,
+  packRnxCaptureRegions,
   rnxCaptureRasterRegions,
   rnxRasterFrames,
   selectRnxRasterNodeIds

package/dist-lib/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/cloud-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/cloud-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/cloud-contract.ts
 var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;

package/dist-lib/cloud.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/cloud.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/config.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/replacement-module-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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;
@@ -49,6 +49,7 @@ __export(src_exports, {
   isRnxScreenCapture: () => isRnxScreenCapture,
   jumpToSourceBabelPlugin: () => sootsimJumpToSourceBabelPlugin,
   metroPlugin: () => metro_plugin_default,
+  packRnxCaptureRegions: () => packRnxCaptureRegions,
   rnxCaptureRasterRegions: () => rnxCaptureRasterRegions,
   rnxPlugin: () => rnxPlugin,
   rnxRasterFrames: () => rnxRasterFrames,
@@ -3204,6 +3205,95 @@ function rnxCaptureRasterRegions(capture) {
     return frame ? [{ key: String(nodeId), nodeId, frame }] : [];
   });
 }
+function packRnxCaptureRegions(regions, pixelRatio, surface) {
+  const physical = regions.map((region) => {
+    const left = Math.floor(region.frame.x * pixelRatio);
+    const top = Math.floor(region.frame.y * pixelRatio);
+    const right = Math.ceil((region.frame.x + region.frame.width) * pixelRatio);
+    const bottom = Math.ceil((region.frame.y + region.frame.height) * pixelRatio);
+    if (left < 0 || top < 0 || right > surface.pixelWidth || bottom > surface.pixelHeight || right <= left || bottom <= top) {
+      throw new Error(`capture region ${region.key} is outside the app surface`);
+    }
+    return {
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: {
+        x: left / pixelRatio,
+        y: top / pixelRatio,
+        width: (right - left) / pixelRatio,
+        height: (bottom - top) / pixelRatio
+      },
+      sourceX: left,
+      sourceY: top,
+      pixelWidth: right - left,
+      pixelHeight: bottom - top
+    };
+  });
+  const largestWidth = Math.max(...physical.map((region) => region.pixelWidth));
+  const totalArea = physical.reduce(
+    (area, region) => area + region.pixelWidth * region.pixelHeight,
+    0
+  );
+  if (totalArea > 4194304) {
+    throw new Error("capture region pixels exceed the atlas budget");
+  }
+  const candidates = [
+    largestWidth,
+    Math.max(largestWidth, Math.ceil(Math.sqrt(totalArea))),
+    Math.max(largestWidth, surface.pixelWidth),
+    4096
+  ];
+  const ordered = [...physical].sort(
+    (left, right) => right.pixelHeight - left.pixelHeight || right.pixelWidth - left.pixelWidth || left.key.localeCompare(right.key)
+  );
+  let best = null;
+  for (const candidate of [...new Set(candidates)]) {
+    if (candidate > 4096) continue;
+    let x = 0;
+    let y = 0;
+    let rowHeight = 0;
+    let usedWidth = 0;
+    const packed = [];
+    for (const region of ordered) {
+      if (x > 0 && x + region.pixelWidth > candidate) {
+        y += rowHeight;
+        x = 0;
+        rowHeight = 0;
+      }
+      packed.push({ ...region, atlasX: x, atlasY: y });
+      x += region.pixelWidth;
+      rowHeight = Math.max(rowHeight, region.pixelHeight);
+      usedWidth = Math.max(usedWidth, x);
+    }
+    const height2 = y + rowHeight;
+    if (height2 > 4096 || usedWidth * height2 > 4194304) continue;
+    const result = { width: usedWidth, height: height2, regions: packed };
+    if (!best || result.width * result.height < best.width * best.height) best = result;
+  }
+  if (!best) throw new Error("capture regions cannot fit in one bounded atlas");
+  const width = best.width / pixelRatio;
+  const height = best.height / pixelRatio;
+  return {
+    width,
+    height,
+    pixelWidth: best.width,
+    pixelHeight: best.height,
+    regions: best.regions,
+    atlasRegions: best.regions.map((region) => ({
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: region.frame,
+      // a region flush with the far edge is anchored to the logical edge so
+      // its source never runs past the atlas by a rounding hair
+      source: {
+        x: region.atlasX + region.pixelWidth === best.width ? width - region.frame.width : region.atlasX / pixelRatio,
+        y: region.atlasY + region.pixelHeight === best.height ? height - region.frame.height : region.atlasY / pixelRatio,
+        width: region.frame.width,
+        height: region.frame.height
+      }
+    }))
+  };
+}
 function captureRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -3259,7 +3349,7 @@ function isRnxScreenCapture(value) {
   return captureRecord(tree.viewport) && captureInteger(tree.viewport.width) && tree.viewport.width > 0 && captureInteger(tree.viewport.height) && tree.viewport.height > 0 && captureInteger(tree.rootNodeId) && (tree.commitRevision === void 0 || captureInteger(tree.commitRevision)) && Array.isArray(tree.nodes) && tree.nodes.every(captureNode) && (visual === void 0 || visual.kind === "png" && (visual.producer === "headless-cpu-app-surface" || visual.producer === "browser-compositor-app-surface") && typeof visual.dataUri === "string" && visual.dataUri.startsWith("data:image/png;base64,") && captureInteger(visual.pixelWidth) && visual.pixelWidth > 0 && captureInteger(visual.pixelHeight) && visual.pixelHeight > 0);
 }
 function isRnxCaptureRegionAtlas(value) {
-  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
+  if (!captureRecord(value) || value.kind !== "png-atlas" || value.producer !== "headless-cpu-app-surface" && value.producer !== "browser-compositor-app-surface" || typeof value.dataUri !== "string" || !value.dataUri.startsWith("data:image/png;base64,") || !captureNumber(value.width) || value.width <= 0 || !captureNumber(value.height) || value.height <= 0 || !captureInteger(value.pixelWidth) || value.pixelWidth <= 0 || !captureInteger(value.pixelHeight) || value.pixelHeight <= 0 || !Array.isArray(value.regions) || value.regions.length === 0 || value.regions.length > 256) {
     return false;
   }
   const scale = value.pixelWidth / value.width;
@@ -4363,6 +4453,7 @@ function sootsimJumpToSourceBabelPlugin(api, options = {}) {
   isRnxScreenCapture,
   jumpToSourceBabelPlugin,
   metroPlugin,
+  packRnxCaptureRegions,
   rnxCaptureRasterRegions,
   rnxPlugin,
   rnxRasterFrames,

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

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/jump-to-source-native.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/menu.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/public-brand.ts
 var name = "rnx";

package/dist-lib/metro-fingerprint-registry.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/metro-fingerprint-registry.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-fingerprint-registry.ts
 var RNX_METRO_FINGERPRINT_SCHEMA_VERSION = 2;

package/dist-lib/metro-production-bundle.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/metro-production-bundle.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-production-bundle.ts
 var RNXSIM_METRO_MODULE_PATHS_PREFIX = "globalThis.__sootsimModulePaths=";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/public-brand.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/react-native-host-modules.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/react-native-host-modules.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/react-native-host-modules.ts
 var REACT_NATIVE_PASSTHROUGH_SPECIFIERS = [

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/swift-submit.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/swift-submit.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/swift-submit.ts
 var SWIFT_COMPILE_PATH = "/api/swift-compile";

package/dist-lib/swift.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.542 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.544 | (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": "rnxsim",
-  "version": "0.1.542",
+  "version": "0.1.544",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/src/capture-contract.ts

@@ -318,6 +318,146 @@ export function rnxCaptureRasterRegions(
   })
 }
 
+/** a region request snapped to the surface pixel grid and placed in the atlas */
+export interface RnxPackedCaptureRegion extends RnxCaptureRegionRequest {
+  /** top-left of the region on the app surface, in pixels */
+  sourceX: number
+  sourceY: number
+  pixelWidth: number
+  pixelHeight: number
+  /** top-left of the region inside the atlas, in pixels */
+  atlasX: number
+  atlasY: number
+}
+
+export interface RnxPackedCaptureAtlas {
+  /** logical atlas dimensions; pixel dimensions are these times the pixel ratio */
+  width: number
+  height: number
+  pixelWidth: number
+  pixelHeight: number
+  regions: RnxPackedCaptureRegion[]
+  /** the wire regions a producer publishes beside the encoded atlas */
+  atlasRegions: RnxCaptureAtlasRegion[]
+}
+
+// the bounded selective-layer atlas every producer ships: regions snapped to
+// whole surface pixels, shelf-packed into the smallest of a few candidate
+// widths, and mapped back to logical atlas coordinates. one packer for the
+// headless renderer (which draws isolated subtrees into the slots) and the
+// browser producer (which crops them out of a screen-sized screenshot), so a
+// consumer never learns which one made the artifact from the layout.
+export function packRnxCaptureRegions(
+  regions: readonly RnxCaptureRegionRequest[],
+  pixelRatio: number,
+  surface: { pixelWidth: number; pixelHeight: number },
+): RnxPackedCaptureAtlas {
+  const physical = regions.map((region) => {
+    const left = Math.floor(region.frame.x * pixelRatio)
+    const top = Math.floor(region.frame.y * pixelRatio)
+    const right = Math.ceil((region.frame.x + region.frame.width) * pixelRatio)
+    const bottom = Math.ceil((region.frame.y + region.frame.height) * pixelRatio)
+    if (
+      left < 0 ||
+      top < 0 ||
+      right > surface.pixelWidth ||
+      bottom > surface.pixelHeight ||
+      right <= left ||
+      bottom <= top
+    ) {
+      throw new Error(`capture region ${region.key} is outside the app surface`)
+    }
+    return {
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: {
+        x: left / pixelRatio,
+        y: top / pixelRatio,
+        width: (right - left) / pixelRatio,
+        height: (bottom - top) / pixelRatio,
+      },
+      sourceX: left,
+      sourceY: top,
+      pixelWidth: right - left,
+      pixelHeight: bottom - top,
+    }
+  })
+  const largestWidth = Math.max(...physical.map((region) => region.pixelWidth))
+  const totalArea = physical.reduce(
+    (area, region) => area + region.pixelWidth * region.pixelHeight,
+    0,
+  )
+  if (totalArea > 4_194_304) {
+    throw new Error('capture region pixels exceed the atlas budget')
+  }
+  const candidates = [
+    largestWidth,
+    Math.max(largestWidth, Math.ceil(Math.sqrt(totalArea))),
+    Math.max(largestWidth, surface.pixelWidth),
+    4_096,
+  ]
+  const ordered = [...physical].sort(
+    (left, right) =>
+      right.pixelHeight - left.pixelHeight ||
+      right.pixelWidth - left.pixelWidth ||
+      left.key.localeCompare(right.key),
+  )
+  let best: { width: number; height: number; regions: RnxPackedCaptureRegion[] } | null =
+    null
+  for (const candidate of [...new Set(candidates)]) {
+    if (candidate > 4_096) continue
+    let x = 0
+    let y = 0
+    let rowHeight = 0
+    let usedWidth = 0
+    const packed: RnxPackedCaptureRegion[] = []
+    for (const region of ordered) {
+      if (x > 0 && x + region.pixelWidth > candidate) {
+        y += rowHeight
+        x = 0
+        rowHeight = 0
+      }
+      packed.push({ ...region, atlasX: x, atlasY: y })
+      x += region.pixelWidth
+      rowHeight = Math.max(rowHeight, region.pixelHeight)
+      usedWidth = Math.max(usedWidth, x)
+    }
+    const height = y + rowHeight
+    if (height > 4_096 || usedWidth * height > 4_194_304) continue
+    const result = { width: usedWidth, height, regions: packed }
+    if (!best || result.width * result.height < best.width * best.height) best = result
+  }
+  if (!best) throw new Error('capture regions cannot fit in one bounded atlas')
+  const width = best.width / pixelRatio
+  const height = best.height / pixelRatio
+  return {
+    width,
+    height,
+    pixelWidth: best.width,
+    pixelHeight: best.height,
+    regions: best.regions,
+    atlasRegions: best.regions.map((region) => ({
+      key: region.key,
+      nodeId: region.nodeId,
+      frame: region.frame,
+      // a region flush with the far edge is anchored to the logical edge so
+      // its source never runs past the atlas by a rounding hair
+      source: {
+        x:
+          region.atlasX + region.pixelWidth === best.width
+            ? width - region.frame.width
+            : region.atlasX / pixelRatio,
+        y:
+          region.atlasY + region.pixelHeight === best.height
+            ? height - region.frame.height
+            : region.atlasY / pixelRatio,
+        width: region.frame.width,
+        height: region.frame.height,
+      },
+    })),
+  }
+}
+
 export interface RnxCaptureAtlasRegion extends RnxCaptureRegionRequest {
   /** source rectangle inside the packed atlas, in logical atlas coordinates */
   source: RnxCaptureRect
@@ -325,7 +465,7 @@ export interface RnxCaptureAtlasRegion extends RnxCaptureRegionRequest {
 
 export interface RnxCaptureRegionAtlas {
   kind: 'png-atlas'
-  producer: 'headless-cpu-app-surface'
+  producer: 'headless-cpu-app-surface' | 'browser-compositor-app-surface'
   dataUri: string
   /** logical atlas dimensions; the encoded PNG uses pixelWidth × pixelHeight */
   width: number
@@ -533,7 +673,8 @@ export function isRnxCaptureRegionAtlas(value: unknown): value is RnxCaptureRegi
   if (
     !captureRecord(value) ||
     value.kind !== 'png-atlas' ||
-    value.producer !== 'headless-cpu-app-surface' ||
+    (value.producer !== 'headless-cpu-app-surface' &&
+      value.producer !== 'browser-compositor-app-surface') ||
     typeof value.dataUri !== 'string' ||
     !value.dataUri.startsWith('data:image/png;base64,') ||
     !captureNumber(value.width) ||

package/src/index.ts

@@ -39,6 +39,7 @@ export {
   isRnxCaptureRegionAtlas,
   isRnxScreenCapture,
   rnxCaptureRasterRegions,
+  packRnxCaptureRegions,
   rnxRasterFrames,
   RNX_SCREEN_CAPTURE_VERSION,
   selectRnxRasterNodeIds,
@@ -54,6 +55,8 @@ export {
   type RnxCaptureSource,
   type RnxCaptureStyleTokenBinding,
   type RnxCaptureTextLine,
+  type RnxPackedCaptureAtlas,
+  type RnxPackedCaptureRegion,
   type RnxCaptureTextSegment,
   type RnxCaptureTree,
   type RnxCaptureVisualEvidence,