@juangadm/pre-post 0.2.0 → 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * .pre-post.json — per-repo configuration. Optional; every field has a default.
+ * `resolveSettings` is the one place defaults, config, and CLI overrides meet.
+ */
+import { PrePostConfig } from './types.js';
+export declare const CONFIG_FILENAME = ".pre-post.json";
+export declare const CONFIG_DEFAULTS: {
+    viewports: string[];
+    threshold: number;
+    minChangedPixels: number;
+    maxRoutes: number;
+    fullPage: boolean;
+    maxHeight: number;
+    scale: number;
+    assetsBranch: string;
+    pruneDays: number;
+};
+export interface Settings {
+    viewports: string[];
+    threshold: number;
+    minChangedPixels: number;
+    maxRoutes: number;
+    fullPage: boolean;
+    maxHeight: number;
+    scale: number;
+    assetsBranch: string;
+    pruneDays: number;
+}
+/** Defaults < .pre-post.json < explicit overrides (undefined overrides are ignored). */
+export declare function resolveSettings(config?: PrePostConfig, overrides?: Partial<Settings>): Settings;
+export declare function configPath(repoRoot: string): string;
+export declare function loadConfig(repoRoot: string): PrePostConfig;
+export declare function saveConfig(repoRoot: string, config: PrePostConfig): void;
+/** Merge a partial update into the on-disk config (creating it if needed). */
+export declare function updateConfig(repoRoot: string, patch: Partial<PrePostConfig>): PrePostConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,eAAe;eACU,MAAM,EAAE;;;;;;;;;CAS7C,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,GAAE,aAAkB,EAAE,SAAS,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAcvG;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAU1D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAExE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAI3F"}

package/dist/config.js

@@ -0,0 +1,60 @@
+/**
+ * .pre-post.json — per-repo configuration. Optional; every field has a default.
+ * `resolveSettings` is the one place defaults, config, and CLI overrides meet.
+ */
+import fs from 'fs';
+import path from 'path';
+export const CONFIG_FILENAME = '.pre-post.json';
+export const CONFIG_DEFAULTS = {
+    viewports: ['desktop', 'mobile'],
+    threshold: 0.001,
+    minChangedPixels: 40,
+    maxRoutes: 6,
+    fullPage: true,
+    maxHeight: 2400,
+    scale: 2,
+    assetsBranch: 'pre-post-assets',
+    pruneDays: 90,
+};
+/** Defaults < .pre-post.json < explicit overrides (undefined overrides are ignored). */
+export function resolveSettings(config = {}, overrides = {}) {
+    const pick = (key) => (overrides[key] ?? config[key] ?? CONFIG_DEFAULTS[key]);
+    return {
+        viewports: pick('viewports'),
+        threshold: pick('threshold'),
+        minChangedPixels: pick('minChangedPixels'),
+        maxRoutes: pick('maxRoutes'),
+        fullPage: pick('fullPage'),
+        maxHeight: pick('maxHeight'),
+        scale: pick('scale'),
+        assetsBranch: pick('assetsBranch'),
+        pruneDays: pick('pruneDays'),
+    };
+}
+export function configPath(repoRoot) {
+    return path.join(repoRoot, CONFIG_FILENAME);
+}
+export function loadConfig(repoRoot) {
+    const file = configPath(repoRoot);
+    if (!fs.existsSync(file))
+        return {};
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        if (parsed && typeof parsed === 'object')
+            return parsed;
+        return {};
+    }
+    catch (err) {
+        throw new Error(`${CONFIG_FILENAME} is not valid JSON: ${err.message}`);
+    }
+}
+export function saveConfig(repoRoot, config) {
+    fs.writeFileSync(configPath(repoRoot), JSON.stringify(config, null, 2) + '\n');
+}
+/** Merge a partial update into the on-disk config (creating it if needed). */
+export function updateConfig(repoRoot, patch) {
+    const next = { ...loadConfig(repoRoot), ...patch };
+    saveConfig(repoRoot, next);
+    return next;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAa;IAC5C,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,EAAE;IACpB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,iBAAiB;IAC/B,SAAS,EAAE,EAAE;CACd,CAAC;AAcF,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,SAAwB,EAAE,EAAE,YAA+B,EAAE;IAC3F,MAAM,IAAI,GAAG,CAA2B,GAAM,EAAe,EAAE,CAC7D,CAAC,SAAS,CAAC,GAAG,CAAC,IAAK,MAA4B,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAgB,CAAC;IAChG,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,gBAAgB,EAAE,IAAI,CAAC,kBAAkB,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;QAC1B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;QAClC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAuB,CAAC;QACzE,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,eAAe,uBAAwB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAqB;IAChE,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAA6B;IAC1E,MAAM,IAAI,GAAG,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IACnD,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/diff-pool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A small worker pool for pixel diffs. Runs inline when worker threads are
+ * unavailable (e.g. executing from TypeScript sources under a test runner).
+ */
+import { DiffJob, DiffJobResult } from './diff-worker.js';
+export declare class DiffPool {
+    private readonly size;
+    private workers;
+    private queue;
+    private inline;
+    constructor(size?: number);
+    run(job: DiffJob): Promise<DiffJobResult>;
+    private spawn;
+    private pump;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=diff-pool.d.ts.map

package/dist/diff-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-pool.d.ts","sourceRoot":"","sources":["../src/diff-pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAkB,MAAM,kBAAkB,CAAC;AAa1E,qBAAa,QAAQ;IAKP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEM,IAAI,SAAiD;IAElF,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAOzC,OAAO,CAAC,KAAK;IA8Bb,OAAO,CAAC,IAAI;IAmBN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/diff-pool.js

@@ -0,0 +1,89 @@
+/**
+ * A small worker pool for pixel diffs. Runs inline when worker threads are
+ * unavailable (e.g. executing from TypeScript sources under a test runner).
+ */
+import os from 'os';
+import { Worker } from 'worker_threads';
+import { executeDiffJob } from './diff-worker.js';
+function runInline(p) {
+    try {
+        p.resolve(executeDiffJob(p.job));
+    }
+    catch (e) {
+        p.reject(e);
+    }
+}
+export class DiffPool {
+    size;
+    workers = [];
+    queue = [];
+    inline = false;
+    constructor(size = Math.max(1, Math.min(4, os.cpus().length - 1))) {
+        this.size = size;
+    }
+    run(job) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ job, resolve, reject });
+            this.pump();
+        });
+    }
+    spawn() {
+        try {
+            const worker = new Worker(new URL('./diff-worker.js', import.meta.url));
+            const slot = { worker, busy: null };
+            worker.on('message', (msg) => {
+                const pending = slot.busy;
+                slot.busy = null;
+                if (pending) {
+                    if (msg.error)
+                        pending.reject(new Error(msg.error));
+                    else
+                        pending.resolve(msg);
+                }
+                this.pump();
+            });
+            worker.on('error', () => {
+                // The worker died: finish its job inline and stop using workers if none are left.
+                const pending = slot.busy;
+                slot.busy = null;
+                this.workers = this.workers.filter(w => w !== slot);
+                if (pending)
+                    runInline(pending);
+                if (this.workers.length === 0)
+                    this.inline = true;
+                this.pump();
+            });
+            this.workers.push(slot);
+            return slot;
+        }
+        catch {
+            this.inline = true;
+            return null;
+        }
+    }
+    pump() {
+        while (this.queue.length) {
+            if (this.inline) {
+                runInline(this.queue.shift());
+                continue;
+            }
+            let slot = this.workers.find(w => !w.busy);
+            if (!slot && this.workers.length < this.size)
+                slot = this.spawn() ?? undefined;
+            if (!slot) {
+                if (this.inline)
+                    continue; // spawn failed: drain inline
+                return; // all workers busy: wait for a message
+            }
+            const pending = this.queue.shift();
+            slot.busy = pending;
+            const { before, after } = pending.job;
+            slot.worker.postMessage(pending.job, [before.buffer, after.buffer]);
+        }
+    }
+    async close() {
+        await Promise.all(this.workers.map(w => w.worker.terminate()));
+        this.workers = [];
+    }
+}
+//# sourceMappingURL=diff-pool.js.map

package/dist/diff-pool.js.map

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

package/dist/diff-worker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Worker-thread entry: diff two PNGs held in memory and write every output.
+ * Keeps pixel work and file I/O off the main thread so captures keep flowing.
+ */
+import { DiffOptions } from './diff.js';
+export interface DiffJob {
+    /** PNG bytes; transferred to the worker, so the caller must not reuse them. */
+    before: Uint8Array;
+    after: Uint8Array;
+    /** Where to write pre, post, diff, and (when produced) crops. */
+    outputs: {
+        before: string;
+        after: string;
+        diff: string;
+        cropBefore: string;
+        cropAfter: string;
+    };
+    options?: DiffOptions;
+}
+export interface DiffJobResult {
+    changedRatio: number;
+    changedPixels: number;
+    sizeChanged: boolean;
+    hasCrop: boolean;
+    hasHighlight: boolean;
+    error?: string;
+}
+export declare function executeDiffJob(job: DiffJob): DiffJobResult;
+//# sourceMappingURL=diff-worker.d.ts.map

package/dist/diff-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-worker.d.ts","sourceRoot":"","sources":["../src/diff-worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAc,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,OAAO;IACtB,+EAA+E;IAC/E,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChG,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAkB1D"}

package/dist/diff-worker.js

@@ -0,0 +1,38 @@
+/**
+ * Worker-thread entry: diff two PNGs held in memory and write every output.
+ * Keeps pixel work and file I/O off the main thread so captures keep flowing.
+ */
+import fs from 'fs';
+import { parentPort } from 'worker_threads';
+import { diffImages } from './diff.js';
+export function executeDiffJob(job) {
+    const before = Buffer.from(job.before.buffer, job.before.byteOffset, job.before.byteLength);
+    const after = Buffer.from(job.after.buffer, job.after.byteOffset, job.after.byteLength);
+    fs.writeFileSync(job.outputs.before, before);
+    fs.writeFileSync(job.outputs.after, after);
+    const result = diffImages(before, after, job.options);
+    if (result.highlight)
+        fs.writeFileSync(job.outputs.diff, result.highlight);
+    if (result.crop) {
+        fs.writeFileSync(job.outputs.cropBefore, result.crop.before);
+        fs.writeFileSync(job.outputs.cropAfter, result.crop.after);
+    }
+    return {
+        changedRatio: result.changedRatio,
+        changedPixels: result.changedPixels,
+        sizeChanged: result.sizeChanged,
+        hasCrop: Boolean(result.crop),
+        hasHighlight: Boolean(result.highlight),
+    };
+}
+if (parentPort) {
+    parentPort.on('message', (job) => {
+        try {
+            parentPort.postMessage(executeDiffJob(job));
+        }
+        catch (err) {
+            parentPort.postMessage({ error: err.message });
+        }
+    });
+}
+//# sourceMappingURL=diff-worker.js.map

package/dist/diff-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-worker.js","sourceRoot":"","sources":["../src/diff-worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAe,MAAM,WAAW,CAAC;AAoBpD,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxF,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,SAAS;QAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,IAAI,UAAU,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAY,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,UAAW,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAW,CAAC,WAAW,CAAC,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAmB,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/diff.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pixel diff between two PNG screenshots.
+ *
+ * Pure JS (pixelmatch + pngjs): no native build step, works everywhere the
+ * CLI runs. Produces a change ratio, the bounding box of the change, a
+ * highlight image, and tight crops of before/after around the change.
+ */
+import { PNG } from 'pngjs';
+import { DiffRegion, DiffResult } from './types.js';
+export interface DiffOptions {
+    /** Padding around the change region for crops, in device pixels. Default 80 */
+    padding?: number;
+    /** Minimum crop size in device pixels. Default 800x400 */
+    minCrop?: {
+        width: number;
+        height: number;
+    };
+    /** Integer factor to shrink the highlight image by (e.g. 2 for 2x captures). Default 1 */
+    highlightDownscale?: number;
+}
+/** Box-filter downscale by an integer factor. */
+export declare function downscale(src: PNG, factor: number): PNG;
+export declare function decodePng(buffer: Buffer): PNG;
+/** Expand a region by padding and to a minimum size, clamped to the canvas. */
+export declare function expandRegion(region: DiffRegion, canvas: {
+    width: number;
+    height: number;
+}, padding: number, min: {
+    width: number;
+    height: number;
+}): DiffRegion;
+/**
+ * Compare two PNG buffers. Images of different sizes are padded onto a shared
+ * canvas so a height change shows up as a change rather than an error.
+ */
+export declare function diffImages(beforePng: Buffer, afterPng: Buffer, options?: DiffOptions): DiffResult;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA+BD,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAoBvD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAE7C;AAsBD,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC,UAAU,CAqBZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CAsDrG"}

package/dist/diff.js

@@ -0,0 +1,171 @@
+/**
+ * Pixel diff between two PNG screenshots.
+ *
+ * Pure JS (pixelmatch + pngjs): no native build step, works everywhere the
+ * CLI runs. Produces a change ratio, the bounding box of the change, a
+ * highlight image, and tight crops of before/after around the change.
+ */
+import pixelmatch from 'pixelmatch';
+import { PNG } from 'pngjs';
+const DIFF_COLOR = [255, 0, 0];
+const AA_COLOR = [255, 200, 0];
+/** Background used to pad images of different sizes. */
+const PAD_COLOR = [255, 255, 255];
+/** pixelmatch per-pixel color distance (0..1). */
+const PIXEL_THRESHOLD = 0.1;
+/** No crop when the change covers more than this fraction of the canvas. */
+const CROP_MAX_RATIO = 0.5;
+function padTo(src, width, height, bg) {
+    if (src.width === width && src.height === height)
+        return src;
+    const out = new PNG({ width, height });
+    for (let i = 0; i < out.data.length; i += 4) {
+        out.data[i] = bg[0];
+        out.data[i + 1] = bg[1];
+        out.data[i + 2] = bg[2];
+        out.data[i + 3] = 255;
+    }
+    PNG.bitblt(src, out, 0, 0, src.width, src.height, 0, 0);
+    return out;
+}
+function crop(src, region) {
+    const out = new PNG({ width: region.width, height: region.height });
+    PNG.bitblt(src, out, region.x, region.y, region.width, region.height, 0, 0);
+    return encode(out);
+}
+function encode(png) {
+    return PNG.sync.write(png, { deflateLevel: 4, filterType: 4 });
+}
+/** Box-filter downscale by an integer factor. */
+export function downscale(src, factor) {
+    if (factor <= 1)
+        return src;
+    const w = Math.max(1, Math.floor(src.width / factor));
+    const h = Math.max(1, Math.floor(src.height / factor));
+    const out = new PNG({ width: w, height: h });
+    const n = factor * factor;
+    for (let y = 0; y < h; y++) {
+        for (let x = 0; x < w; x++) {
+            let r = 0, g = 0, b = 0, a = 0;
+            for (let dy = 0; dy < factor; dy++) {
+                let i = ((y * factor + dy) * src.width + x * factor) * 4;
+                for (let dx = 0; dx < factor; dx++, i += 4) {
+                    r += src.data[i];
+                    g += src.data[i + 1];
+                    b += src.data[i + 2];
+                    a += src.data[i + 3];
+                }
+            }
+            const o = (y * w + x) * 4;
+            out.data[o] = r / n;
+            out.data[o + 1] = g / n;
+            out.data[o + 2] = b / n;
+            out.data[o + 3] = a / n;
+        }
+    }
+    return out;
+}
+export function decodePng(buffer) {
+    return PNG.sync.read(buffer);
+}
+/** Bounding box of pixels painted with the diff color. */
+function boundingBox(diff) {
+    const { width, height, data } = diff;
+    let minX = width, minY = height, maxX = -1, maxY = -1;
+    for (let y = 0; y < height; y++) {
+        const row = y * width * 4;
+        for (let x = 0; x < width; x++) {
+            const i = row + x * 4;
+            if (data[i] === DIFF_COLOR[0] && data[i + 1] === DIFF_COLOR[1] && data[i + 2] === DIFF_COLOR[2]) {
+                if (x < minX)
+                    minX = x;
+                if (x > maxX)
+                    maxX = x;
+                if (y < minY)
+                    minY = y;
+                if (y > maxY)
+                    maxY = y;
+            }
+        }
+    }
+    if (maxX < 0)
+        return null;
+    return { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 };
+}
+/** Expand a region by padding and to a minimum size, clamped to the canvas. */
+export function expandRegion(region, canvas, padding, min) {
+    let x0 = region.x - padding;
+    let y0 = region.y - padding;
+    let x1 = region.x + region.width + padding;
+    let y1 = region.y + region.height + padding;
+    const grow = (lo, hi, target, limit) => {
+        const size = hi - lo;
+        if (size < target) {
+            const extra = target - size;
+            lo -= Math.floor(extra / 2);
+            hi += Math.ceil(extra / 2);
+        }
+        if (lo < 0) {
+            hi -= lo;
+            lo = 0;
+        }
+        if (hi > limit) {
+            lo -= hi - limit;
+            hi = limit;
+        }
+        return [Math.max(0, lo), Math.min(limit, hi)];
+    };
+    [x0, x1] = grow(x0, x1, Math.min(min.width, canvas.width), canvas.width);
+    [y0, y1] = grow(y0, y1, Math.min(min.height, canvas.height), canvas.height);
+    return { x: x0, y: y0, width: x1 - x0, height: y1 - y0 };
+}
+/**
+ * Compare two PNG buffers. Images of different sizes are padded onto a shared
+ * canvas so a height change shows up as a change rather than an error.
+ */
+export function diffImages(beforePng, afterPng, options = {}) {
+    const bg = PAD_COLOR;
+    const a = decodePng(beforePng);
+    const b = decodePng(afterPng);
+    const width = Math.max(a.width, b.width);
+    const height = Math.max(a.height, b.height);
+    const sizeChanged = a.width !== b.width || a.height !== b.height;
+    const before = padTo(a, width, height, bg);
+    const after = padTo(b, width, height, bg);
+    const diff = new PNG({ width, height });
+    const changedPixels = pixelmatch(before.data, after.data, diff.data, width, height, {
+        threshold: PIXEL_THRESHOLD,
+        includeAA: false,
+        alpha: 0.5,
+        diffColor: DIFF_COLOR,
+        aaColor: AA_COLOR,
+        diffMask: false,
+    });
+    const region = changedPixels > 0 ? boundingBox(diff) : null;
+    const result = {
+        changedRatio: changedPixels / (width * height),
+        changedPixels,
+        width,
+        height,
+        region,
+        sizeChanged,
+        // Identical pages need no highlight; skip the downscale + deflate.
+        highlight: region ? encode(downscale(diff, options.highlightDownscale ?? 1)) : undefined,
+    };
+    if (region) {
+        const area = region.width * region.height;
+        if (area / (width * height) <= CROP_MAX_RATIO) {
+            const expanded = expandRegion(region, { width, height }, options.padding ?? 80, options.minCrop ?? { width: 800, height: 400 });
+            // Only crop when it meaningfully zooms in.
+            if (expanded.width * expanded.height < width * height * 0.8) {
+                result.crop = {
+                    before: crop(before, expanded),
+                    after: crop(after, expanded),
+                    region: expanded,
+                };
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Preflight: browser present, GitHub auth, dev server, target reachability.
+ * Fixes what it can (installs the headless shell) and otherwise stops with
+ * exactly one sentence telling the human what to do.
+ */
+import { HttpStatusError } from './errors.js';
+export { NeedsHumanError } from './errors.js';
+/**
+ * Launch (and install if needed) the shared headless browser. The instance
+ * stays open for the captures that follow, so this is the launch, not a probe.
+ */
+export declare function ensureBrowser(): Promise<void>;
+/** Headed browser for `pre-post login`; caller owns and closes it. */
+export declare function launchHeadedBrowser(): Promise<import("playwright-core").Browser>;
+/**
+ * Find a running local dev server. Returns its base URL or null.
+ */
+export declare function detectDevServer(ports?: number[]): Promise<string | null>;
+export interface ProbeResult {
+    /** HTTP status, or null when the host could not be reached at all */
+    status: number | null;
+    vercel: boolean;
+}
+/**
+ * Probe a base URL with the headers we will use for capture.
+ */
+export declare function probeUrl(url: string, headers?: Record<string, string>, options?: {
+    timeoutMs?: number;
+    redirect?: RequestRedirect;
+}): Promise<ProbeResult>;
+/**
+ * Explain a 401/403 in one actionable sentence. Accepts a probe result or the typed capture error.
+ */
+export declare function authHint(target: HttpStatusError | {
+    url: string;
+    vercel: boolean;
+}): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAwB,eAAe,EAAqC,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAe9C;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAED,sEAAsE;AACtE,wBAAsB,mBAAmB,+CAMxC;AAID;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,GAAE,MAAM,EAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIzF;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAO,GAC/D,OAAO,CAAC,WAAW,CAAC,CAOtB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAO3F"}

package/dist/doctor.js

@@ -0,0 +1,72 @@
+/**
+ * Preflight: browser present, GitHub auth, dev server, target reachability.
+ * Fixes what it can (installs the headless shell) and otherwise stops with
+ * exactly one sentence telling the human what to do.
+ */
+import { getBrowser, launchBrowserOrInstall } from './browser.js';
+import { hostOf } from './run.js';
+import { BrowserNotFoundError, NeedsHumanError, isVercelResponse } from './errors.js';
+export { NeedsHumanError } from './errors.js';
+const INSTALL_HINT = 'Run: npx playwright-core install chromium-headless-shell   (or set PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH), then re-run.';
+function explainBrowserFailure(err) {
+    if (err instanceof BrowserNotFoundError) {
+        throw new NeedsHumanError(err.installed
+            ? `Chromium was installed but cannot launch. ${INSTALL_HINT}`
+            : `Chromium could not be installed automatically. ${INSTALL_HINT}`);
+    }
+    throw err;
+}
+/**
+ * Launch (and install if needed) the shared headless browser. The instance
+ * stays open for the captures that follow, so this is the launch, not a probe.
+ */
+export async function ensureBrowser() {
+    try {
+        await getBrowser();
+    }
+    catch (err) {
+        explainBrowserFailure(err);
+    }
+}
+/** Headed browser for `pre-post login`; caller owns and closes it. */
+export async function launchHeadedBrowser() {
+    try {
+        return await launchBrowserOrInstall({ headless: false });
+    }
+    catch (err) {
+        explainBrowserFailure(err);
+    }
+}
+const DEV_PORTS = [3000, 3001, 3002, 5173, 5174, 4173, 4321, 8080, 8000, 5000, 4200];
+/**
+ * Find a running local dev server. Returns its base URL or null.
+ */
+export async function detectDevServer(ports = DEV_PORTS) {
+    const results = await Promise.all(ports.map(async (p) => ({ p, ...(await probeUrl(`http://localhost:${p}/`, {}, { timeoutMs: 1500, redirect: 'manual' })) })));
+    const hit = results.find(r => r.status !== null);
+    return hit ? `http://localhost:${hit.p}` : null;
+}
+/**
+ * Probe a base URL with the headers we will use for capture.
+ */
+export async function probeUrl(url, headers = {}, options = {}) {
+    try {
+        const res = await fetch(url, { method: 'GET', headers, redirect: options.redirect ?? 'follow', signal: AbortSignal.timeout(options.timeoutMs ?? 10_000) });
+        return { status: res.status, vercel: isVercelResponse(res.headers) };
+    }
+    catch {
+        return { status: null, vercel: false };
+    }
+}
+/**
+ * Explain a 401/403 in one actionable sentence. Accepts a probe result or the typed capture error.
+ */
+export function authHint(target) {
+    const { url, vercel } = target;
+    const host = hostOf(url);
+    if (vercel || host.endsWith('.vercel.app')) {
+        return `${host} is protected by Vercel Deployment Protection. Either set VERCEL_AUTOMATION_BYPASS_SECRET (Project → Settings → Deployment Protection → Protection Bypass for Automation) or run: npx pre-post login ${url}`;
+    }
+    return `${host} requires a login. Run: npx pre-post login ${url}  (opens a browser once, saves the session locally)`;
+}
+//# sourceMappingURL=doctor.js.map