@agent-scope/render 1.19.0 → 1.20.1

package/README.md

@@ -192,8 +192,13 @@ interface BrowserPoolConfig {
   preset?: 'local' | 'ci-standard' | 'ci-large';
   /** Custom size config — overrides preset when provided. */
   size?: { browsers: number; pagesPerBrowser: number };
-  viewportWidth?: number;   // default: 1440
-  viewportHeight?: number;  // default: 900
+  viewportWidth?: number;    // default: 1440
+  viewportHeight?: number;   // default: 900
+  /**
+   * Device pixel ratio for retina screenshots. Default: 2.
+   * Renders at 2× physical pixels; display at CSS px dimensions for sharp HiDPI output.
+   */
+  deviceScaleFactor?: number; // default: 2
   /** Max ms to wait for a free slot before acquire() rejects. Default: 30_000. */
   acquireTimeoutMs?: number;
 }
@@ -550,9 +555,9 @@ Shared return type for both render paths.
 
 ```typescript
 interface RenderResult {
-  screenshot: Buffer;        // PNG as a Buffer
-  width: number;             // pixel width of the rendered component
-  height: number;            // pixel height
+  screenshot: Buffer;        // PNG as a Buffer (2× physical pixels at default deviceScaleFactor: 2)
+  width: number;             // CSS pixel width of the rendered component (layout size)
+  height: number;            // CSS pixel height
   renderTimeMs: number;      // wall-clock render time in ms
   computedStyles: Record<string, Record<string, string>>;
   // BrowserPool only (when captureXxx options enabled):

package/dist/index.cjs

@@ -683,6 +683,12 @@ function detectHeuristicFlags(errorMessage, componentStack) {
   if (combined.includes("hydrat") || combined.includes("did not match") || combined.includes("server rendered html")) {
     flags.add("HYDRATION_MISMATCH");
   }
+  if (combined.includes("executable doesn't exist") || combined.includes("browserType.launch") || combined.includes("could not find chromium") || combined.includes("please run the following command to download new browsers")) {
+    flags.add("MISSING_BROWSER_BINARY");
+  }
+  if (combined.includes("could not resolve") || combined.includes("cannot find module") || combined.includes("module not found")) {
+    flags.add("MISSING_PROJECT_DEPENDENCY");
+  }
   if (combined.includes("circular") || combined.includes("maximum call stack") || combined.includes("stack overflow")) {
     flags.add("CIRCULAR_DEPENDENCY");
   }