playwriter 0.0.62 → 0.0.80

package/dist/aria-snapshot.d.ts

@@ -26,6 +26,44 @@ export interface ScreenshotResult {
     snapshot: string;
     labelCount: number;
 }
+/**
+ * LLM-optimal max dimension. Claude auto-resizes images larger than 1568px
+ * on any edge, adding latency. Token cost: (width * height) / 750.
+ */
+export declare const LLM_MAX_DIMENSION = 1568;
+export interface ResizeImageOptions {
+    /** Input: file path or Buffer */
+    input: string | Buffer;
+    /** Max pixels on longest edge. Default 1568 (Claude-optimal).
+     *  Ignored if explicit width/height provided. */
+    maxDimension?: number;
+    /** Explicit target width in px (aspect ratio preserved unless both width+height set) */
+    width?: number;
+    /** Explicit target height in px */
+    height?: number;
+    /** How to fit when both width+height specified. Default 'inside' (preserve aspect ratio, no crop) */
+    fit?: 'inside' | 'cover' | 'contain' | 'fill';
+    /** JPEG quality 1-100. Default 80 */
+    quality?: number;
+    /** Output file path. Defaults to overwriting the input file (when input is a path) */
+    output?: string;
+}
+export interface ResizeImageResult {
+    buffer: Buffer;
+    mimeType: 'image/jpeg';
+    /** Only set if output path was provided */
+    path?: string;
+}
+/**
+ * Resize an image using sharp. Useful for shrinking screenshots before reading
+ * them back into context so they consume fewer tokens.
+ *
+ * Default behavior (no width/height): fits within 1568×1568px, preserving
+ * aspect ratio, never upscales. This is optimal for Claude vision.
+ *
+ * Explicit width/height: resizes to those dimensions using the fit strategy.
+ */
+export declare function resizeImage(options: ResizeImageOptions): Promise<ResizeImageResult>;
 export interface AriaSnapshotResult {
     snapshot: string;
     tree: AriaSnapshotNode[];
@@ -140,7 +178,7 @@ export declare function finalizeSnapshotOutput(lines: SnapshotLine[], nodes: Sna
  * await page.locator(selector).click()
  * ```
  */
-export declare function getAriaSnapshot({ page, frame, locator, refFilter, interactiveOnly, cdp }: {
+export declare function getAriaSnapshot({ page, frame, locator, refFilter, interactiveOnly, cdp, }: {
     page: Page;
     frame?: Frame | FrameLocator;
     locator?: Locator;
@@ -171,7 +209,7 @@ export declare function getAriaSnapshot({ page, frame, locator, refFilter, inter
  * await page.locator('[data-testid="submit-btn"]').click()
  * ```
  */
-export declare function showAriaRefLabels({ page, locator, interactiveOnly, logger }: {
+export declare function showAriaRefLabels({ page, locator, interactiveOnly, logger, }: {
     page: Page;
     locator?: Locator;
     interactiveOnly?: boolean;
@@ -206,7 +244,7 @@ export declare function hideAriaRefLabels({ page }: {
  * await page.locator('[data-testid="submit-btn"]').click()
  * ```
  */
-export declare function screenshotWithAccessibilityLabels({ page, locator, interactiveOnly, collector, logger }: {
+export declare function screenshotWithAccessibilityLabels({ page, locator, interactiveOnly, collector, logger, }: {
     page: Page;
     locator?: Locator;
     interactiveOnly?: boolean;

package/dist/aria-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aria-snapshot.d.ts","sourceRoot":"","sources":["../src/aria-snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aria-snapshot.d.ts","sourceRoot":"","sources":["../src/aria-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/aria-snapshot.js

@@ -6,8 +6,12 @@ import { Sema } from 'async-sema';
 import { getCDPSessionForPage } from './cdp-session.js';
 // Import sharp at module level - resolves to null if not available
 const sharpPromise = import('sharp')
-    .then((m) => { return m.default; })
-    .catch(() => { return null; });
+    .then((m) => {
+    return m.default;
+})
+    .catch(() => {
+    return null;
+});
 export const DEFAULT_SNAPSHOT_FORMAT = 'raw';
 // ============================================================================
 // A11y Client Code Loading
@@ -29,6 +33,78 @@ async function ensureA11yClient(page) {
         await page.evaluate(code);
     }
 }
+// ============================================================================
+// Image Resize Utility
+// ============================================================================
+/**
+ * LLM-optimal max dimension. Claude auto-resizes images larger than 1568px
+ * on any edge, adding latency. Token cost: (width * height) / 750.
+ */
+export const LLM_MAX_DIMENSION = 1568;
+/**
+ * Resize an image using sharp. Useful for shrinking screenshots before reading
+ * them back into context so they consume fewer tokens.
+ *
+ * Default behavior (no width/height): fits within 1568×1568px, preserving
+ * aspect ratio, never upscales. This is optimal for Claude vision.
+ *
+ * Explicit width/height: resizes to those dimensions using the fit strategy.
+ */
+export async function resizeImage(options) {
+    const sharp = await sharpPromise;
+    if (!sharp) {
+        throw new Error('sharp is not installed — install it with: pnpm add sharp');
+    }
+    const inputBuffer = (() => {
+        if (Buffer.isBuffer(options.input)) {
+            return options.input;
+        }
+        return fs.readFileSync(options.input);
+    })();
+    const quality = options.quality ?? 80;
+    const hasExplicitDimensions = options.width !== undefined || options.height !== undefined;
+    const fit = options.fit ?? 'inside';
+    const resizeOpts = (() => {
+        if (hasExplicitDimensions) {
+            return {
+                width: options.width,
+                height: options.height,
+                fit,
+                withoutEnlargement: false,
+            };
+        }
+        const max = options.maxDimension ?? LLM_MAX_DIMENSION;
+        return {
+            width: max,
+            height: max,
+            fit,
+            withoutEnlargement: true,
+        };
+    })();
+    const buffer = await sharp(inputBuffer)
+        .resize(resizeOpts)
+        .jpeg({ quality })
+        .toBuffer();
+    // Default: overwrite input file. When input is a Buffer, no file is written
+    // unless output is explicitly set.
+    const outputPath = (() => {
+        if (options.output) {
+            return options.output;
+        }
+        if (typeof options.input === 'string') {
+            return options.input;
+        }
+        return undefined;
+    })();
+    if (outputPath) {
+        fs.writeFileSync(outputPath, buffer);
+    }
+    return {
+        buffer,
+        mimeType: 'image/jpeg',
+        ...(outputPath ? { path: outputPath } : {}),
+    };
+}
 export function buildShortRefMap({ refs }) {
     const map = new Map();
     refs.forEach((entry, index) => {
@@ -58,9 +134,7 @@ const INTERACTIVE_ROLES = new Set([
     'video',
     'audio',
 ]);
-const LABEL_ROLES = new Set([
-    'labeltext',
-]);
+const LABEL_ROLES = new Set(['labeltext']);
 const MAX_LABEL_POSITION_CONCURRENCY = 24;
 const BOX_MODEL_TIMEOUT_MS = 5000;
 const CONTEXT_ROLES = new Set([
@@ -78,12 +152,7 @@ const CONTEXT_ROLES = new Set([
     'row',
     'cell',
 ]);
-const SKIP_WRAPPER_ROLES = new Set([
-    'generic',
-    'group',
-    'none',
-    'presentation',
-]);
+const SKIP_WRAPPER_ROLES = new Set(['generic', 'group', 'none', 'presentation']);
 const TEST_ID_ATTRS = [
     'data-testid',
     'data-test-id',
@@ -130,7 +199,7 @@ function buildLocatorFromStable(stable) {
     const escaped = escapeLocatorValue(stable.value);
     return `[${stable.attr}="${escaped}"]`;
 }
-function buildBaseLocator({ role, name, stable }) {
+function buildBaseLocator({ role, name, stable, }) {
     if (stable) {
         return buildLocatorFromStable(stable);
     }
@@ -158,7 +227,7 @@ function getAxRole(node) {
     const role = getAxValueString(node.role);
     return role.toLowerCase();
 }
-function buildSnapshotLine({ role, name, baseLocator, indent, hasChildren }) {
+function buildSnapshotLine({ role, name, baseLocator, indent, hasChildren, }) {
     const prefix = '  '.repeat(indent);
     let text = `${prefix}- ${role}`;
     if (name) {
@@ -199,13 +268,15 @@ export function buildRawSnapshotTree(options) {
     }
     const role = getAxRole(node);
     const name = getAxValueString(node.name).trim();
-    const children = (node.childIds ?? []).map((childId) => {
+    const children = (node.childIds ?? [])
+        .map((childId) => {
         return buildRawSnapshotTree({
             nodeId: childId,
             axById: options.axById,
             isNodeInScope: options.isNodeInScope,
         });
-    }).filter(isTruthy);
+    })
+        .filter(isTruthy);
     const inScope = options.isNodeInScope(node) || children.length > 0;
     if (!inScope) {
         return null;
@@ -429,7 +500,8 @@ export function finalizeSnapshotOutput(lines, nodes, shortRefMap) {
         return acc;
     }, []);
     let lineLocatorIndex = 0;
-    const snapshot = lines.map((line) => {
+    const snapshot = lines
+        .map((line) => {
         let text = line.text;
         if (line.baseLocator) {
             const locator = locatorSequence[lineLocatorIndex];
@@ -440,7 +512,8 @@ export function finalizeSnapshotOutput(lines, nodes, shortRefMap) {
             text += ':';
         }
         return text;
-    }).join('\n');
+    })
+        .join('\n');
     let nodeLocatorIndex = 0;
     const applyLocators = (items) => {
         return items.map((item) => {
@@ -585,8 +658,8 @@ async function resolveFrame({ frame, page }) {
  * await page.locator(selector).click()
  * ```
  */
-export async function getAriaSnapshot({ page, frame, locator, refFilter, interactiveOnly = false, cdp }) {
-    const session = cdp || await getCDPSessionForPage({ page });
+export async function getAriaSnapshot({ page, frame, locator, refFilter, interactiveOnly = false, cdp, }) {
+    const session = cdp || (await getCDPSessionForPage({ page }));
     // Resolve FrameLocator to an actual Frame. FrameLocator (from locator.contentFrame())
     // is a scoping helper without CDP access. We need the real Frame from page.frames()
     // which has frameId() for OOPIF session attachment.
@@ -596,16 +669,16 @@ export async function getAriaSnapshot({ page, frame, locator, refFilter, interac
     let oopifSessionId = null;
     const frameId = resolvedFrame?.frameId() ?? null;
     if (frameId) {
-        const { targetInfos } = await session.send('Target.getTargets');
+        const { targetInfos } = (await session.send('Target.getTargets'));
         const frameUrl = resolvedFrame.url();
         const iframeTarget = targetInfos.find((t) => {
             return t.type === 'iframe' && t.url === frameUrl;
         });
         if (iframeTarget) {
-            const { sessionId } = await session.send('Target.attachToTarget', {
+            const { sessionId } = (await session.send('Target.attachToTarget', {
                 targetId: iframeTarget.targetId,
                 flatten: true,
-            });
+            }));
             oopifSessionId = sessionId;
             await session.send('Runtime.runIfWaitingForDebugger', undefined, oopifSessionId);
         }
@@ -623,7 +696,7 @@ export async function getAriaSnapshot({ page, frame, locator, refFilter, interac
             }, { attr: scopeAttr, value: scopeValue });
             scopeApplied = true;
         }
-        const { nodes: domNodes } = await session.send('DOM.getFlattenedDocument', { depth: -1, pierce: true }, oopifSessionId);
+        const { nodes: domNodes } = (await session.send('DOM.getFlattenedDocument', { depth: -1, pierce: true }, oopifSessionId));
         const { domById, domByBackendId, childrenByParent } = buildDomIndex(domNodes);
         let scopeRootNodeId = null;
         let scopeRootBackendId = null;
@@ -636,11 +709,9 @@ export async function getAriaSnapshot({ page, frame, locator, refFilter, interac
                 }
             }
         }
-        const allowedBackendIds = scopeRootNodeId
-            ? buildBackendIdSet(scopeRootNodeId, childrenByParent, domById)
-            : null;
+        const allowedBackendIds = scopeRootNodeId ? buildBackendIdSet(scopeRootNodeId, childrenByParent, domById) : null;
         const axParams = !oopifSessionId && frameId ? { frameId } : undefined;
-        const { nodes: axNodes } = await session.send('Accessibility.getFullAXTree', axParams, oopifSessionId);
+        const { nodes: axNodes } = (await session.send('Accessibility.getFullAXTree', axParams, oopifSessionId));
         const axById = new Map();
         for (const node of axNodes) {
             axById.set(node.nodeId, node);
@@ -710,9 +781,11 @@ export async function getAriaSnapshot({ page, frame, locator, refFilter, interac
             const rootNode = axById.get(rootAxNodeId);
             const rootRole = rootNode ? getAxRole(rootNode) : '';
             const rawRoots = rootNode && (rootRole === 'rootwebarea' || rootRole === 'webarea') && rootNode.childIds
-                ? rootNode.childIds.map((childId) => {
+                ? rootNode.childIds
+                    .map((childId) => {
                     return buildRawSnapshotTree({ nodeId: childId, axById, isNodeInScope });
-                }).filter(isTruthy)
+                })
+                    .filter(isTruthy)
                 : [buildRawSnapshotTree({ nodeId: rootAxNodeId, axById, isNodeInScope })].filter(isTruthy);
             const filtered = rawRoots.flatMap((rawNode) => {
                 if (interactiveOnly) {
@@ -791,7 +864,16 @@ export async function getAriaSnapshot({ page, frame, locator, refFilter, interac
                     if (!target) {
                         return null;
                     }
-                    const testIdAttrs = ['data-testid', 'data-test-id', 'data-test', 'data-cy', 'data-pw', 'data-qa', 'data-e2e', 'data-automation-id'];
+                    const testIdAttrs = [
+                        'data-testid',
+                        'data-test-id',
+                        'data-test',
+                        'data-cy',
+                        'data-pw',
+                        'data-qa',
+                        'data-e2e',
+                        'data-automation-id',
+                    ];
                     for (const attr of testIdAttrs) {
                         const value = target.getAttribute(attr);
                         if (value) {
@@ -874,7 +956,7 @@ function isTruthy(value) {
 }
 async function getLabelBoxesForRefs({ page, refs, maxConcurrency = MAX_LABEL_POSITION_CONCURRENCY, logger, cdp, }) {
     const log = logger?.info ?? logger?.error ?? console.error;
-    const session = cdp || await getCDPSessionForPage({ page });
+    const session = cdp || (await getCDPSessionForPage({ page }));
     const sema = new Sema(maxConcurrency);
     const labelRefs = refs.filter((ref) => {
         return Boolean(ref.backendNodeId) && INTERACTIVE_ROLES.has(ref.role);
@@ -892,9 +974,13 @@ async function getLabelBoxesForRefs({ page, refs, maxConcurrency = MAX_LABEL_POS
             await sema.acquire();
             try {
                 const response = await Promise.race([
-                    session.send('DOM.getBoxModel', { backendNodeId: ref.backendNodeId }),
+                    session.send('DOM.getBoxModel', {
+                        backendNodeId: ref.backendNodeId,
+                    }),
                     new Promise((resolve) => {
-                        setTimeout(() => { resolve(null); }, BOX_MODEL_TIMEOUT_MS);
+                        setTimeout(() => {
+                            resolve(null);
+                        }, BOX_MODEL_TIMEOUT_MS);
                     }),
                 ]);
                 completed++;
@@ -949,7 +1035,7 @@ async function getLabelBoxesForRefs({ page, refs, maxConcurrency = MAX_LABEL_POS
  * await page.locator('[data-testid="submit-btn"]').click()
  * ```
  */
-export async function showAriaRefLabels({ page, locator, interactiveOnly = true, logger }) {
+export async function showAriaRefLabels({ page, locator, interactiveOnly = true, logger, }) {
     const startTime = Date.now();
     const log = logger?.info ?? logger?.error ?? console.error;
     log(`[showAriaRefLabels] starting...`);
@@ -984,7 +1070,8 @@ export async function showAriaRefLabels({ page, locator, interactiveOnly = true,
             }
             if (a11y?.computeA11ySnapshot) {
                 const rootElement = root || document.body;
-                return a11y.computeA11ySnapshot({ root: rootElement, interactiveOnly: intOnly, renderLabels: true }).labelCount;
+                return a11y.computeA11ySnapshot({ root: rootElement, interactiveOnly: intOnly, renderLabels: true })
+                    .labelCount;
             }
             throw new Error('a11y client not loaded');
         }, { entries: shortLabels, root: rootHandle, interactiveOnly });
@@ -1035,7 +1122,7 @@ export async function hideAriaRefLabels({ page }) {
  * await page.locator('[data-testid="submit-btn"]').click()
  * ```
  */
-export async function screenshotWithAccessibilityLabels({ page, locator, interactiveOnly = true, collector, logger }) {
+export async function screenshotWithAccessibilityLabels({ page, locator, interactiveOnly = true, collector, logger, }) {
     const log = logger?.info ?? logger?.error;
     const showLabelsStart = Date.now();
     const { snapshot, labelCount } = await showAriaRefLabels({ page, locator, interactiveOnly, logger });
@@ -1053,15 +1140,12 @@ export async function screenshotWithAccessibilityLabels({ page, locator, interac
     }
     const screenshotPath = path.join(tmpDir, filename);
     // Get viewport size to clip screenshot to visible area
-    const viewport = await page.evaluate('({ width: window.innerWidth, height: window.innerHeight })');
-    // Max 1568px on any edge (larger gets auto-resized by Claude, adding latency)
-    // Token formula: tokens = (width * height) / 750
-    const MAX_DIMENSION = 1568;
+    const viewport = (await page.evaluate('({ width: window.innerWidth, height: window.innerHeight })'));
     // Check if sharp is available for resizing
     const sharp = await sharpPromise;
-    // Clip dimensions: if sharp unavailable, limit capture area to MAX_DIMENSION
-    const clipWidth = sharp ? viewport.width : Math.min(viewport.width, MAX_DIMENSION);
-    const clipHeight = sharp ? viewport.height : Math.min(viewport.height, MAX_DIMENSION);
+    // Clip dimensions: if sharp unavailable, limit capture area to LLM_MAX_DIMENSION
+    const clipWidth = sharp ? viewport.width : Math.min(viewport.width, LLM_MAX_DIMENSION);
+    const clipHeight = sharp ? viewport.height : Math.min(viewport.height, LLM_MAX_DIMENSION);
     // Take viewport screenshot with scale: 'css' to ignore device pixel ratio
     const screenshotStart = Date.now();
     const rawBuffer = await page.screenshot({
@@ -1073,23 +1157,16 @@ export async function screenshotWithAccessibilityLabels({ page, locator, interac
     if (log) {
         log(`page.screenshot: ${Date.now() - screenshotStart}ms`);
     }
-    // Resize with sharp if available, otherwise use clipped raw buffer
+    // Resize with resizeImage if sharp available, otherwise use clipped raw buffer
     const resizeStart = Date.now();
     const buffer = await (async () => {
         if (!sharp) {
-            logger?.error?.('[playwriter] sharp not available, using clipped screenshot (max', MAX_DIMENSION, 'px)');
+            logger?.error?.('[playwriter] sharp not available, using clipped screenshot (max', LLM_MAX_DIMENSION, 'px)');
             return rawBuffer;
         }
         try {
-            return await sharp(rawBuffer)
-                .resize({
-                width: MAX_DIMENSION,
-                height: MAX_DIMENSION,
-                fit: 'inside', // Scale down to fit, preserving aspect ratio
-                withoutEnlargement: true, // Don't upscale small images
-            })
-                .jpeg({ quality: 80 })
-                .toBuffer();
+            const result = await resizeImage({ input: rawBuffer });
+            return result.buffer;
         }
         catch (err) {
             logger?.error?.('[playwriter] sharp resize failed, using raw buffer:', err);