pursr 0.7.0 → 0.7.1

package/bin/pursr.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // pursr CLI. Thin wrapper around src/* that mirrors the npm bin.
 
 import { VERSION } from "../src/index.js";
@@ -79,14 +79,15 @@ await loadPlugins(pluginPaths);
       case "diff": {
         if (!url) die("missing url"); const ref = b; if (!ref) die("diff: missing <ref.png>");
         const out = c || makeOut("diff.png"); const threshold = d !== undefined ? Number(d) : 0.1;
+        const flags = parseFlags(argv.slice(5));
         // --ai / --ai-model / --ai-base-url / --ai-api-key
         const useAi = argv.includes("--ai");
         const aiModel = (() => { const i = argv.indexOf("--ai-model"); return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined; })();
         const aiBaseUrl = (() => { const i = argv.indexOf("--ai-base-url"); return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined; })();
         const aiApiKey = (() => { const i = argv.indexOf("--ai-api-key"); return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined; })();
         const r = useAi
-          ? await runDiffWithAi(url, ref, out, threshold, { model: aiModel, baseUrl: aiBaseUrl, apiKey: aiApiKey })
-          : await runDiff(url, ref, out, threshold);
+          ? await runDiffWithAi(url, ref, out, threshold, flags, { model: aiModel, baseUrl: aiBaseUrl, apiKey: aiApiKey })
+          : await runDiff(url, ref, out, threshold, flags);
         console.log(JSON.stringify(r, null, 2)); break;
       }
       case "seq": { if (!url) die("missing url"); const actions = readArg(b); if (!actions) die("seq: missing <actions.json> (or @file)"); const out = c || makeOut("seq.png"); const r = await runSeq(url, actions, out); console.log(JSON.stringify(r, null, 2)); break; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pursr",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "private": false,
   "description": "pursr — Visual QA, audit, and MCP for the browser. One CLI + one MCP server for screenshots, sweeps, baselines, diffs, axe-core a11y audits, HAR capture, and auth state — with parallel sweep workers, auto-healing selectors, and a plugin system. Zero browser bundled: drives your system Chrome via Playwright.",
   "homepage": "https://github.com/0xheycat/pursr",

package/src/diff.js

@@ -3,9 +3,9 @@
 import { readFileSync, writeFileSync, existsSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { launch, newPage } from "./runway.js";
-import { DEFAULT_VIEWPORT } from "./viewport.js";
-import { gotoOrThrow, settle } from "./overlays.js";
-import { requireArg } from "./util.js";
+import { resolveViewport } from "./viewport.js";
+import { gotoOrThrow, settle, applyCamera, waitForStableFrame } from "./overlays.js";
+import { asNum, requireArg } from "./util.js";
 import { aiDiffSidecar } from "./ai-diff.js";
 
 const DIFF_DEFAULT_THRESHOLD = 0.1;
@@ -20,7 +20,7 @@ async function loadPixelmatch() {
   catch { throw new Error("pixelmatch not found. Install: npm i pixelmatch"); }
 }
 
-export async function runDiff(url, refPath, out, threshold, browser) {
+export async function runDiff(url, refPath, out, threshold, flags = {}, browser) {
   requireArg("url", url, "string");
   requireArg("refPath", refPath, "string");
   const t = threshold !== undefined ? Number(threshold) : DIFF_DEFAULT_THRESHOLD;
@@ -28,10 +28,21 @@ export async function runDiff(url, refPath, out, threshold, browser) {
   const PNG = await loadPngjs();
   const pixelmatch = await loadPixelmatch();
   const ownBrowser = !browser;
+  const viewport = resolveViewport(flags || {});
   browser = browser || await launch();
   try {
-    const page = await newPage(browser, DEFAULT_VIEWPORT);
+    const page = await newPage(browser, viewport);
     const r = await gotoOrThrow(page, url); await settle(page);
+    if (flags && (flags["wait-frame"] || flags["no-animation"])) {
+      await waitForStableFrame(page, asNum(flags["wait-frame"], 600));
+    }
+    if (flags && (flags.zoom || flags.panX || flags.panY)) {
+      await applyCamera(page, {
+        zoom: asNum(flags.zoom, 1),
+        panX: asNum(flags.panX, 0),
+        panY: asNum(flags.panY, 0),
+      });
+    }
     const currentPath = out ? out.replace(/\.png$/i, "-current.png") : join(dirname(refPath), "current.png");
     await page.screenshot({ path: currentPath, fullPage: false });
     const refPng = PNG.sync.read(readFileSync(refPath));
@@ -53,8 +64,8 @@ export async function runDiff(url, refPath, out, threshold, browser) {
  * summary of the visual differences. The AI summary is written to <out>.ai.json
  * and also returned on the result object.
  */
-export async function runDiffWithAi(url, refPath, out, threshold, aiOpts, browser) {
-  const r = await runDiff(url, refPath, out, threshold, browser);
+export async function runDiffWithAi(url, refPath, out, threshold, flags, aiOpts, browser) {
+  const r = await runDiff(url, refPath, out, threshold, flags, browser);
   if (r.error) return r;
   try {
     const curPath = r.currentPath;

package/src/plugin-audit.js

@@ -10,6 +10,7 @@
 // Dependencies: axe-core (npm i axe-core)
 
 import { launch, newPage } from "./runway.js";
+import { createRequire } from "node:module";
 import { resolveViewport } from "./viewport.js";
 import { gotoOrThrow, settle } from "./overlays.js";
 import { writeFileSync, mkdirSync, readFileSync, existsSync } from "node:fs";
@@ -87,11 +88,29 @@ let _axeSource = null;
 async function getAxeSource() {
   if (_axeSource) return _axeSource;
   // Try node_modules/axe-core
+  // Primary: use createRequire to resolve axe-core from this module (works for the
+  // pursr package itself, the linked repo, or any project that has axe-core installed).
+  try {
+    const req = createRequire(import.meta.url);
+    const resolved = req.resolve("axe-core");
+    const dir = resolved.replace(/[\\\/][^\\\/]+$/, "");
+    for (const fname of ["axe.min.js", "axe.js"]) {
+      const p = dir + "/" + fname;
+      if (existsSync(p)) { _axeSource = readFileSync(p, "utf8"); return _axeSource; }
+    }
+  } catch { /* fall through to path-based lookup */ }
   const paths = [
     join(process.cwd(), "node_modules", "axe-core", "axe.min.js"),
     join(process.cwd(), "node_modules", "axe-core", "axe.js"),
     new URL("..", import.meta.url).pathname && join(dirname(new URL(import.meta.url).pathname), "node_modules", "axe-core", "axe.min.js"),
     join(dirname(process.execPath), "node_modules", "axe-core", "axe.min.js"),
+    // Global npm install (Windows: %APPDATA%\npm\node_modules, Unix: /usr/lib/node_modules)
+    join(process.env.APPDATA || "", "npm", "node_modules", "axe-core", "axe.min.js"),
+    join(process.env.HOME || "", ".npm-global", "lib", "node_modules", "axe-core", "axe.min.js"),
+    join("/usr", "lib", "node_modules", "axe-core", "axe.min.js"),
+    join("/usr", "local", "lib", "node_modules", "axe-core", "axe.min.js"),
+    // The pursr package's own node_modules (when running from local repo or via node bin)
+    join(dirname(new URL(import.meta.url).pathname), "..", "node_modules", "axe-core", "axe.min.js"),
   ];
   for (const p of paths) {
     if (p && existsSync(p)) {
@@ -99,8 +118,7 @@ async function getAxeSource() {
       return _axeSource;
     }
   }
-  throw new Error("axe-core not found. Install: npm i axe-core");
-}
+throw new Error("axe-core not found. Install: npm i axe-core");}
 
 // ─── Group helper ───────────────────────────────────────────────────────