@juangadm/pre-post 1.0.0 → 1.2.0

package/dist/types.d.ts

@@ -48,6 +48,14 @@ export interface CaptureResult {
     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;
 }
@@ -87,6 +95,23 @@ export interface DiffResult {
         after: Buffer;
         region: DiffRegion;
     };
+    /** Vertical displacement explaining most of the difference, when one does */
+    shift?: ShiftSummary;
+}
+/**
+ * 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 {
@@ -104,6 +129,8 @@ export interface RouteDetectionOptions {
     framework?: Framework;
     /** Maximum number of routes to return (default: 6) */
     maxRoutes?: number;
+    /** Where warnings go. Left unset, they are silent. */
+    log?: (msg: string) => void;
 }
 export interface PrePostConfig {
     /** Production base URL — the "before" state */
@@ -114,13 +141,16 @@ export interface PrePostConfig {
     routes?: string[];
     /** Sample URLs for dynamic routes, e.g. { "/blog/[slug]": "/blog/hello" } */
     samples?: Record<string, string>;
-    /** Viewports to capture. Default: ["desktop", "mobile"] */
+    /** 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;
@@ -137,32 +167,80 @@ export interface PrePostConfig {
 }
 /** Pre, post, and (when there was a change) diff and crop images, as local paths or URLs. */
 export interface ArtifactSet {
-    before: string;
-    after: string;
+    /** 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 declare const ARTIFACT_KINDS: readonly ["before", "after", "diff", "cropBefore", "cropAfter"];
+export type ArtifactKind = typeof ARTIFACT_KINDS[number];
+/**
+ * The filename segment for an artifact kind, e.g. `home-desktop-<segment>.png`.
+ *
+ * One mapping, because two of them is what went wrong: the capture wrote
+ * `-pre`/`-post` while the assets branch published `-before`/`-after`, so the
+ * file on disk and the image in the PR had different names for the same
+ * screenshot. Renaming the literals on one side would only have moved the
+ * seam — the crops would still have been `-before-crop` locally and
+ * `-cropBefore` published.
+ */
+export declare function artifactSuffix(kind: ArtifactKind): string;
 export interface RouteCaptureOutcome {
     route: string;
     /** Route actually requested (after sample substitution) */
     resolvedRoute: string;
     viewport: string;
-    status: 'changed' | 'unchanged' | 'error';
+    status: 'changed' | 'unchanged' | 'added' | 'removed' | 'error';
     changedRatio?: number;
     sizeChanged?: boolean;
     error?: string;
     files?: ArtifactSet;
     urls?: ArtifactSet;
     durationMs?: number;
-    /** Extra context, e.g. "new page (404 on production)" */
+    /** 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;
+    /** Changed share once the move is undone; `changedRatio` is the raw figure. */
+    residualRatio: number;
 }
 export interface PrRunResult {
     repo: string;
     prNumber?: number;
     commentUrl?: string;
+    /** Whether `commentUrl` points at the PR description or at a comment. */
+    commentKind?: 'description' | 'comment';
     beforeBase: string;
     afterBase: string;
     outcomes: RouteCaptureOutcome[];

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

@@ -7,4 +7,21 @@ export const VIEWPORT_PRESETS = {
     mobile: { width: 375, height: 812 },
 };
 export const ARTIFACT_KINDS = ['before', 'after', 'diff', 'cropBefore', 'cropAfter'];
+/**
+ * The filename segment for an artifact kind, e.g. `home-desktop-<segment>.png`.
+ *
+ * One mapping, because two of them is what went wrong: the capture wrote
+ * `-pre`/`-post` while the assets branch published `-before`/`-after`, so the
+ * file on disk and the image in the PR had different names for the same
+ * screenshot. Renaming the literals on one side would only have moved the
+ * seam — the crops would still have been `-before-crop` locally and
+ * `-cropBefore` published.
+ */
+export function artifactSuffix(kind) {
+    switch (kind) {
+        case 'cropBefore': return 'before-crop';
+        case 'cropAfter': return 'after-crop';
+        default: return kind;
+    }
+}
 //# 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;AAkKF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAU,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;AAI9F;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC,CAAC,OAAO,aAAa,CAAC;QACxC,KAAK,WAAW,CAAC,CAAC,OAAO,YAAY,CAAC;QACtC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juangadm/pre-post",
-  "version": "1.0.0",
+  "version": "1.2.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",

package/skill/SKILL.md

@@ -10,9 +10,31 @@ allowed-tools:
 # pre-post
 
 One command does everything: detects the routes this branch changed, screenshots them on
-production ("Pre") and on the local dev server ("Post") at desktop and mobile, pixel-diffs
-them, uploads the images to a `pre-post-assets` branch, and posts or updates a single
-comment on the open PR. The human reviews on GitHub.
+desktop, pixel-diffs them, uploads the images to a `pre-post-assets` branch, and
+posts or updates a single comment on the open PR. The human reviews on GitHub.
+
+It picks both sides itself:
+
+- **Post** (this branch) — the PR's preview deployment when one exists, read from the GitHub
+  Deployments API or, for providers that only comment (Vercel's GitHub app does), from the
+  deployment bot's PR comment. Otherwise a dev server: one already running, or one it starts
+  and stops itself.
+- **Pre** (the baseline) — `before` from `.pre-post.json`, otherwise the production
+  deployment for the commit this branch forked from, otherwise that base commit itself,
+  checked out into a throwaway worktree and served locally.
+
+Both sides always come from the same kind of environment. Pairing a deployment against a
+dev server would compare different builds — a dev server renders Next.js's dev badge that
+production never shows — so a diff would carry changes the branch never made.
+
+So on a PR with a preview deployment, no dev server and no checkout are needed — anyone on
+the team can run it against anyone's PR. With nothing deployed and nothing running, it
+serves both sides itself.
+
+The last baseline needs no network at all, so the tool still works inside a sandbox, a CI
+container, or behind an egress allowlist where no deployment URL is reachable. It also
+compares against exactly what the branch forked from, rendered in the same environment as
+the Post side. Pass `--no-local-baseline` to turn it off.
 
 ## Run
 
@@ -20,14 +42,25 @@ comment on the open PR. The human reviews on GitHub.
 npx -y @juangadm/pre-post@latest pr
 ```
 
-Add `--before https://production-url` the first time in a repo (it is saved to
-`.pre-post.json`). Add `--routes /a,/b` when the user names pages explicitly.
+Add `--routes /a,/b` when the user names pages explicitly. Add
+`--before https://production-url` only if the run reports it cannot work out the baseline
+(it is then saved to `.pre-post.json` for next time).
+
+## What it posts
+
+The visual changes go at the **top of the PR description**, in a delimited block that
+re-runs replace in place — the author's own text is never touched. If the PR cannot be
+edited (a fork, a read-only token) it falls back to a single sticky comment.
+
+Each changed route shows **Pre beside Post**, per viewport, full pages in a `<details>`. No
+overlay, no percentage. A page that moved says `Content shifted down 48px`; relay as written.
 
 ## Rules
 
 - Run the command once. Do not open, read, or describe the screenshot files; the PR
   comment is the deliverable. Report the summary the command prints, plus the comment link.
-- Do not start dev servers, switch branches, or use a browser tool yourself.
+- Do not switch branches, start dev servers, or use a browser tool yourself. The command
+  handles all three.
 - Exit code 3 means a human must do one thing (log in, start the dev server, pass
   `--before`). Relay that one sentence verbatim and stop.
 - Do not use `--dry-run` unless the user asks to preview without posting.
@@ -39,7 +72,7 @@ Add `--before https://production-url` the first time in a repo (it is saved to
 | Flag | Use when |
 |------|----------|
 | `--routes /a,/b` | The user names the pages |
-| `--viewports desktop` | Desktop only (default is desktop + mobile) |
+| `-r`, `--responsive` | Desktop and mobile (default is desktop only) |
 | `--viewport-only` | First screen only instead of full page |
 | `--pr <n>` | The branch has several PRs or the lookup fails |
 | `--dry-run` | Preview locally, post nothing |