@juangadm/pre-post 0.3.0 → 1.1.0

package/dist/types.d.ts

@@ -5,6 +5,18 @@ export interface ViewportSize {
 export type ViewportPreset = 'desktop' | 'tablet' | 'mobile';
 export type ViewportConfig = ViewportPreset | ViewportSize;
 export declare const VIEWPORT_PRESETS: Record<ViewportPreset, ViewportSize>;
+export interface AuthOptions {
+    /** Extra request headers sent with every request (e.g. Vercel bypass). */
+    headers?: Record<string, string>;
+    /** Cookies to set before navigation. */
+    cookies?: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+        path?: string;
+        url?: string;
+    }>;
+}
 export interface CaptureOptions {
     /** URL to capture (file://, http://, https://) */
     url: string;
@@ -14,6 +26,16 @@ export interface CaptureOptions {
     viewport?: ViewportConfig;
     /** Capture full scrollable page instead of viewport. Default: false */
     fullPage?: boolean;
+    /** Maximum page height (CSS px) for full-page captures. Default: 3× viewport height */
+    maxHeight?: number;
+    /** Device scale factor. Default: 2 */
+    scale?: number;
+    /** Hard cap on settle wait (ms). Default: 8000 */
+    settleTimeout?: number;
+    /** Extra fixed wait after settle (ms). Default: 0 */
+    wait?: number;
+    /** Auth headers / cookies */
+    auth?: AuthOptions;
 }
 export interface CaptureResult {
     /** Raw PNG image data */
@@ -24,6 +46,18 @@ export interface CaptureResult {
     url: string;
     /** CSS selector used, if any */
     selector?: string;
+    /** HTTP status of the main document */
+    status?: number;
+    /** URL the browser ended on, which is not the requested one after a redirect */
+    finalUrl?: string;
+    /** Document title, used to recognise a sign-in wall that answered with 200 */
+    title?: string;
+    /** Visible text, used to tell "the same site, changed" from "a different site" */
+    text?: string;
+    /** Response looked like it came from Vercel (deployment protection) */
+    vercel?: boolean;
+    /** Wall-clock milliseconds for navigation + settle + screenshot */
+    durationMs: number;
 }
 export interface BeforeAfterCaptureOptions {
     before: CaptureOptions | string;
@@ -35,32 +69,51 @@ export interface BeforeAfterCaptureResult {
     before: CaptureResult;
     after: CaptureResult;
 }
-export type ImageInput = string | Buffer;
-export interface FromImagesOptions {
-    /** Before image (file path or Buffer) */
-    before: ImageInput;
-    /** After image (file path or Buffer) */
-    after: ImageInput;
-    /** Labels for markdown output */
-    labels?: {
-        before?: string;
-        after?: string;
-    };
+export interface DiffRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
 }
-export interface FromImagesResult {
-    /** Markdown table for PR comments */
-    markdown: string;
-    /** Before image buffer */
-    beforeImage: Buffer;
-    /** After image buffer */
-    afterImage: Buffer;
+export interface DiffResult {
+    /** Fraction of pixels that differ, 0..1 (over the union canvas) */
+    changedRatio: number;
+    /** Number of differing pixels */
+    changedPixels: number;
+    /** Canvas size used for comparison (device pixels) */
+    width: number;
+    height: number;
+    /** Bounding box of all changes in device pixels, or null when identical */
+    region: DiffRegion | null;
+    /** Whether the two images had different dimensions */
+    sizeChanged: boolean;
+    /** Highlight image: grayscale page with changed pixels in red (PNG). Absent when identical. */
+    highlight?: Buffer;
+    /** Crops of before/after around the changed region, when the change is localized */
+    crop?: {
+        before: Buffer;
+        after: Buffer;
+        region: DiffRegion;
+    };
+    /** Vertical displacement explaining most of the difference, when one does */
+    shift?: ShiftSummary;
 }
-export interface BeforeAndAfterOptions {
-    /** Default viewport for all operations */
-    viewport?: ViewportConfig;
-    /** Output directory for saved screenshots */
-    outputDir?: string;
+/**
+ * A layout shift: Post content moved down (or up) by a constant amount from a
+ * given row, and what remains different once the two sides are put back in
+ * register. Plain numbers, so it survives the worker-thread boundary.
+ */
+export interface ShiftSummary {
+    /** Device pixels Post content moved down by; negative means up. */
+    dy: number;
+    /** First row, in Pre coordinates, that moved. Rows above it stayed put. */
+    from: number;
+    /** Changed pixels once Post is aligned with Pre. */
+    alignedChangedPixels: number;
+    /** Aligned changed pixels as a fraction of the canvas. */
+    alignedChangedRatio: number;
 }
+export type Framework = 'nextjs-app' | 'nextjs-pages' | 'vite' | 'generic';
 export interface DetectedRoute {
     /** Route path, e.g., "/dashboard" */
     path: string;
@@ -73,54 +126,112 @@ export interface DetectedRoute {
 }
 export interface RouteDetectionOptions {
     /** Force a specific framework instead of auto-detecting */
-    framework?: 'nextjs-app' | 'nextjs-pages' | 'generic';
-    /** Maximum number of routes to return (default: 5) */
+    framework?: Framework;
+    /** Maximum number of routes to return (default: 6) */
     maxRoutes?: number;
-    /** Git diff target, e.g., "main...HEAD" or "HEAD~1" */
-    diffTarget?: string;
+    /** Where warnings go. Left unset, they are silent. */
+    log?: (msg: string) => void;
 }
-export interface CompareOptions {
-    /** Base URL for "before" state (e.g., production URL) */
-    beforeBase: string;
-    /** Base URL for "after" state (e.g., localhost) */
-    afterBase: string;
-    /** Routes to capture */
-    routes: string[];
-    /** Capture at desktop + mobile viewports */
-    responsive?: boolean;
-    /** Viewport override (used when not in responsive mode) */
-    viewport?: ViewportConfig;
-    /** Output directory for screenshots */
-    output?: string;
-    /** Generate markdown output */
-    markdown?: boolean;
+export interface PrePostConfig {
+    /** Production base URL — the "before" state */
+    before?: string;
+    /** Local base URL — the "after" state (auto-detected when omitted) */
+    after?: string;
+    /** Routes to always include */
+    routes?: string[];
+    /** Sample URLs for dynamic routes, e.g. { "/blog/[slug]": "/blog/hello" } */
+    samples?: Record<string, string>;
+    /** Viewports to capture. Default: ["desktop"] */
+    viewports?: Array<ViewportPreset | string>;
+    /** Extra headers for every request */
+    headers?: Record<string, string>;
+    /** Change ratio (fraction 0..1) at or above which a route counts as changed. Default 0.001 */
+    threshold?: number;
+    /** Absolute changed-pixel floor at or above which a route counts as changed, so small edits on tall pages register. Default 40 */
+    /** Smallest painted change that counts, in CSS pixels². */
+    minChangedArea?: number;
+    /** @deprecated device pixels; use minChangedArea. Converted at the capture scale. */
+    minChangedPixels?: number;
+    /** Max detected routes. Default 6 */
+    maxRoutes?: number;
+    /** Capture full page. Default true */
+    fullPage?: boolean;
+    /** Max full-page height in CSS px. Default 2400 */
+    maxHeight?: number;
+    /** Device scale factor. Default 2 */
+    scale?: number;
+    /** Assets branch name. Default "pre-post-assets" */
+    assetsBranch?: string;
+    /** Skip paths (glob-ish prefixes) from route detection */
+    ignore?: string[];
 }
-export interface VideoOptions {
-    /** Viewport size for the capture */
-    viewport: ViewportSize;
-    /** Recording duration in seconds (default: 3, max: 10) */
-    duration?: number;
-    /** Target frames per second (default: 5, max: 10) */
-    fps?: number;
-    /** Milliseconds to wait after page load before recording (default: 0) */
-    delay?: number;
-    /** CSS selector — scroll element into view before recording */
-    selector?: string;
+/** Pre, post, and (when there was a change) diff and crop images, as local paths or URLs. */
+export interface ArtifactSet {
+    /** Absent when the route has no baseline (a page this branch adds). */
+    before?: string;
+    /** Absent when the branch removed the route. */
+    after?: string;
+    diff?: string;
+    cropBefore?: string;
+    cropAfter?: string;
 }
-export interface VideoResult {
-    /** Raw GIF data */
-    gif: Buffer;
-    /** Output format identifier */
-    format: 'gif';
-    /** Viewport used for capture */
-    viewport: ViewportSize;
-    /** URL that was captured */
-    url: string;
-    /** Actual recording duration in seconds */
-    duration: number;
-    /** Number of frames in the GIF */
-    frameCount: number;
-    /** CSS selector used, if any */
-    selector?: string;
+export declare const ARTIFACT_KINDS: readonly ["before", "after", "diff", "cropBefore", "cropAfter"];
+export interface RouteCaptureOutcome {
+    route: string;
+    /** Route actually requested (after sample substitution) */
+    resolvedRoute: string;
+    viewport: string;
+    status: 'changed' | 'unchanged' | 'added' | 'removed' | 'error';
+    changedRatio?: number;
+    sizeChanged?: boolean;
+    error?: string;
+    files?: ArtifactSet;
+    urls?: ArtifactSet;
+    durationMs?: number;
+    /** sha1 of the baseline capture, for spotting a host that serves one page for every route */
+    baselineHash?: string;
+    /** Extra context, e.g. "new page — no baseline (example.com returned 404)" */
+    note?: string;
+    /** Vertical displacement of Post against Pre, when one explains the change */
+    shift?: RouteShift;
+    /** A side answered with a sign-in wall, so nothing was really compared */
+    blocked?: BlockedSide;
+    /**
+     * How much of the two sides' wording is shared, or null when neither page
+     * had enough text to judge. Near zero on every route means the two sides are
+     * different sites, which a pixel ratio cannot tell you — see `sameness.ts`.
+     */
+    textOverlap?: number | null;
+    /**
+     * The same measure over the two titles. A title is where a site names
+     * itself, so it corroborates a run that only has one route to judge.
+     */
+    titleOverlap?: number | null;
+}
+export interface BlockedSide {
+    side: 'before' | 'after';
+    /** The sign-in page the capture landed on */
+    finalUrl: string;
+    /** Deployment protection, so the bypass secret is the fix */
+    vercel: boolean;
+}
+export interface RouteShift {
+    /** CSS pixels the content moved down by; negative means up. */
+    px: number;
+    /** Whether anything changed beyond the move, judged by the same rule as any other capture. */
+    otherChange: boolean;
+}
+export interface PrRunResult {
+    repo: string;
+    prNumber?: number;
+    commentUrl?: string;
+    beforeBase: string;
+    afterBase: string;
+    outcomes: RouteCaptureOutcome[];
+    skippedDynamic: string[];
+    durationMs: number;
+    markdown: string;
+    /** Local directory holding every captured file */
+    outputDir: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -6,4 +6,5 @@ export const VIEWPORT_PRESETS = {
     tablet: { width: 768, height: 1024 },
     mobile: { width: 375, height: 812 },
 };
+export const ARTIFACT_KINDS = ['before', 'after', 'diff', 'cropBefore', 'cropAfter'];
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,WAAW;AACX,+DAA+D;AAW/D,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACpE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACrC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CACpC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,WAAW;AACX,+DAA+D;AAW/D,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACpE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACrC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CACpC,CAAC;AAmMF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAU,CAAC"}

package/dist/url.d.ts

@@ -0,0 +1,12 @@
+/**
+ * URL helpers shared by the capture layer and the command pipeline.
+ *
+ * Kept out of run.ts so browser.ts can ask "is this loopback?" without
+ * importing the module that imports it.
+ */
+/** Is this URL served from the machine running the command? */
+export declare function isLocalUrl(url: string): boolean;
+export declare function normalizeUrl(url: string): string;
+export declare function hostOf(url: string): string;
+export declare function joinUrl(base: string, route: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/url.js

@@ -0,0 +1,30 @@
+/**
+ * URL helpers shared by the capture layer and the command pipeline.
+ *
+ * Kept out of run.ts so browser.ts can ask "is this loopback?" without
+ * importing the module that imports it.
+ */
+/** Add a scheme to a bare URL (http for loopback hosts, https otherwise) and drop trailing slashes. */
+const LOOPBACK = /^(?:(?:https?|file):\/\/)?(localhost|127\.0\.0\.1|0\.0\.0\.0|\[::1\])(:|\/|$)/i;
+/** Is this URL served from the machine running the command? */
+export function isLocalUrl(url) {
+    return LOOPBACK.test(url);
+}
+export function normalizeUrl(url) {
+    const withScheme = /^(https?|file):\/\//i.test(url)
+        ? url
+        : isLocalUrl(url) ? `http://${url}` : `https://${url}`;
+    return withScheme.replace(/\/+$/, '');
+}
+export function hostOf(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+export function joinUrl(base, route) {
+    return base.replace(/\/+$/, '') + (route.startsWith('/') ? route : `/${route}`);
+}
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uGAAuG;AACvG,MAAM,QAAQ,GAAG,gFAAgF,CAAC;AAElG,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC;QACjD,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC;IACzD,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAa;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AAClF,CAAC"}

package/dist/viewport.d.ts

@@ -1,3 +1,8 @@
 import { ViewportConfig, ViewportSize } from './types.js';
-export declare function resolveViewport(config?: ViewportConfig): ViewportSize;
+/** Accepts a preset name, a "WxH" string, or a size object. */
+export declare function parseViewport(spec: ViewportConfig | string): {
+    label: string;
+    size: ViewportSize;
+};
+export declare function resolveViewport(config?: ViewportConfig | string): ViewportSize;
 //# sourceMappingURL=viewport.d.ts.map

package/dist/viewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAoC,MAAM,YAAY,CAAC;AAE5F,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,YAAY,CAQrE"}
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAoC,MAAM,YAAY,CAAC;AAE5F,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAOlG;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,YAAY,CAE9E"}

package/dist/viewport.js

@@ -1,11 +1,17 @@
 import { VIEWPORT_PRESETS } from './types.js';
+/** Accepts a preset name, a "WxH" string, or a size object. */
+export function parseViewport(spec) {
+    if (typeof spec !== 'string')
+        return { label: `${spec.width}x${spec.height}`, size: spec };
+    const preset = VIEWPORT_PRESETS[spec];
+    if (preset)
+        return { label: spec, size: preset };
+    const m = spec.match(/^(\d+)x(\d+)$/);
+    if (!m)
+        throw new Error(`Invalid viewport "${spec}". Use desktop, tablet, mobile, or WxH (e.g. 1440x900).`);
+    return { label: spec, size: { width: Number(m[1]), height: Number(m[2]) } };
+}
 export function resolveViewport(config) {
-    if (!config) {
-        return VIEWPORT_PRESETS.desktop;
-    }
-    if (typeof config === 'string') {
-        return VIEWPORT_PRESETS[config];
-    }
-    return config;
+    return config ? parseViewport(config).size : VIEWPORT_PRESETS.desktop;
 }
 //# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,MAAwB,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5F,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,IAA6B;IACzD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3F,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAsB,CAAC,CAAC;IACxD,IAAI,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,yDAAyD,CAAC,CAAC;IAC5G,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAgC;IAC9D,OAAO,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC;AACxE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@juangadm/pre-post",
-  "version": "0.3.0",
-  "description": "Visual diff tool for PRs — captures before/after screenshots of web pages",
+  "version": "1.1.0",
+  "description": "Before/after screenshots for pull requests: detect changed routes, capture, pixel-diff, and post a sticky PR comment",
   "author": "Juan Gabriel Delgado (forked from James Clements)",
   "license": "MIT",
   "repository": {
@@ -16,13 +16,12 @@
     "screenshot",
     "before-after",
     "visual-diff",
-    "comparison",
-    "capture",
-    "web",
-    "testing",
-    "cli",
+    "visual-regression",
+    "pull-request",
     "playwright",
-    "pr-screenshots"
+    "pixelmatch",
+    "cli",
+    "claude-code-skill"
   ],
   "type": "module",
   "main": "dist/index.js",
@@ -38,23 +37,23 @@
   },
   "files": [
     "dist",
-    "skill"
+    "skill",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.pkg.json",
+    "prepare": "npm run build",
     "prepublishOnly": "rm -rf dist && npm run build && npm run test:unit",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:unit": "vitest run tests/unit",
-    "test:browser": "vitest run tests/browser",
+    "test:browser": "TEST_BROWSER=true vitest run tests/browser tests/integration",
     "test:integration": "vitest run tests/integration"
   },
-  "dependencies": {
-    "gifenc": "^1.0.3",
-    "playwright": "^1.50.0"
-  },
   "devDependencies": {
     "@types/node": "^22",
+    "@types/pngjs": "^6.0.5",
     "typescript": "5.7.3",
     "vitest": "^3.2.1"
   },
@@ -63,5 +62,13 @@
       "@types/react": "19.2.7",
       "@types/react-dom": "19.2.3"
     }
+  },
+  "dependencies": {
+    "pixelmatch": "^7.2.0",
+    "playwright-core": "1.58.0",
+    "pngjs": "^7.0.0"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }