@juangadm/pre-post 0.3.0 → 1.1.0

package/dist/run.d.ts

@@ -0,0 +1,116 @@
+/**
+ * The capture → diff pipeline shared by `pr` and the two-URL mode.
+ * Every route/viewport pair runs concurrently; the browser's page pool bounds it.
+ */
+import { AuthOptions, RouteCaptureOutcome, ViewportSize } from './types.js';
+export interface CaptureTask {
+    route: string;
+    resolvedRoute: string;
+    viewport: string;
+    size: ViewportSize;
+    beforeUrl: string;
+    afterUrl: string;
+}
+/** Where the two sides came from, so a verdict about them can say which is which. */
+export interface RunSides {
+    before: {
+        url: string;
+        detail?: string;
+    };
+    after: {
+        url: string;
+        detail?: string;
+    };
+    /**
+     * How this caller's user would fix a wrong pairing. Only the command knows:
+     * `pr` chose the baseline and can offer `--before`, while the two-URL mode
+     * was handed both sides as positional arguments, where that flag means
+     * nothing.
+     */
+    fix?: string;
+}
+/**
+ * Why this run cannot be reported as a comparison.
+ *
+ * Two ways to reach the same conclusion, kept apart because they need
+ * different advice: a wall wants credentials, a wrong baseline wants a URL.
+ */
+export interface RunVerdict {
+    kind: 'walled' | 'different-sites';
+    /** The single actionable sentence a human needs. */
+    hint: string;
+}
+export interface RunResult {
+    outcomes: RouteCaptureOutcome[];
+    /** Non-null when the run did not compare what it claims to have compared. */
+    verdict: RunVerdict | null;
+}
+export interface PipelineOptions {
+    outputDir: string;
+    fullPage: boolean;
+    maxHeight: number;
+    scale: number;
+    threshold: number;
+    minChangedArea: number;
+    wait?: number;
+    auth?: AuthOptions;
+    /**
+     * How resolution chose the two sides. Optional: without it a verdict still
+     * fires and names the URLs the captures actually used, which is enough to
+     * act on — it just cannot say *why* that baseline was picked.
+     */
+    sides?: RunSides;
+    log?: (msg: string) => void;
+}
+export declare function routeSlug(route: string): string;
+/**
+ * Did this capture change?
+ *
+ * Two arms, because they cover different regimes and neither covers both:
+ *
+ * - Painted area, in CSS pixels² — the rule for pages. Measured against the
+ *   fixture ladder, every deliberate change covers 242 CSS px² or more while
+ *   every no-op covers exactly 0, so the floor sits in a wide empty band. CSS
+ *   pixels rather than device pixels so it means the same at --scale 1 as at
+ *   --scale 2; the old device-pixel constant was silently four times stricter
+ *   at scale 1, and at ~10 CSS px² amounted to a third of one letter.
+ * - Share of the canvas — the rule for small images. One pixel of a 20x20 icon
+ *   is a quarter of a percent of it and obviously a change, but it will never
+ *   reach an area floor sized for pages.
+ *
+ * On a full page the ratio arm effectively never fires on its own (a recoloured
+ * 16px icon is 0.024% of one), and on a small image the area arm never does.
+ * Dropping either one loses real changes, which is the worse error: reporting
+ * "no visual changes" on a PR that changed something is the one answer that
+ * makes a reviewer stop looking.
+ */
+export declare function isChanged(diff: {
+    changedRatio: number;
+    changedPixels: number;
+}, opts: {
+    minChangedArea: number;
+    threshold: number;
+    scale: number;
+}): boolean;
+/** "shifted down 48px" — the direction spelled out, because the sign is not. */
+export declare function describeShift(px: number): string;
+/**
+ * Did the baseline answer unrelated routes with the same page?
+ *
+ * This is the soft 404 — a not-found view served with status 200, which no
+ * status check can see and which a keyword hunt for "404" would catch only in
+ * English, only when the page says it, and only when no real page happens to
+ * mention it. The durable signal is not the wording but the sameness: a host
+ * that returns pixel-identical bytes for several different routes is serving a
+ * catch-all, and every comparison against it is measuring the distance from
+ * that catch-all rather than from the page.
+ *
+ * It warns rather than reclassifies. Two routes can legitimately render the
+ * same page, and silently turning a real diff into "new page" on a heuristic
+ * would hide exactly the change this tool exists to show. The authoritative
+ * signal (a 404 status) acts; this one only tells the reader what it sees.
+ */
+export declare function softNotFoundWarning(outcomes: RouteCaptureOutcome[], beforeUrl: string): string | null;
+export declare function verdictFor(outcomes: RouteCaptureOutcome[], sides: RunSides): RunVerdict | null;
+export declare function runTasks(tasks: CaptureTask[], opts: PipelineOptions): Promise<RunResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,WAAW,EAA8B,mBAAmB,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AASpH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qFAAqF;AACrF,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IACnC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,6EAA6E;IAC7E,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,EACrD,IAAI,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAIT;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGhD;AA6MD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBrG;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,IAAI,CAY9F;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAkB9F"}

package/dist/run.js

@@ -0,0 +1,316 @@
+/**
+ * The capture → diff pipeline shared by `pr` and the two-URL mode.
+ * Every route/viewport pair runs concurrently; the browser's page pool bounds it.
+ */
+import fs from 'fs';
+import { createHash } from 'crypto';
+import path from 'path';
+import { captureScreenshot } from './browser.js';
+import { checkLanding, signInHint } from './landing.js';
+import { differentSitesHint, looksLikeDifferentSites, textOverlap, titleOverlap } from './sameness.js';
+import { HttpStatusError, NavigationError } from './errors.js';
+import { DiffPool } from './diff-pool.js';
+import { authHint } from './doctor.js';
+import { hostOf } from './url.js';
+export function routeSlug(route) {
+    const slug = route.replace(/^\/+|\/+$/g, '').replace(/[^\w.-]+/g, '-').replace(/^-+|-+$/g, '');
+    return slug || 'home';
+}
+/**
+ * Did this capture change?
+ *
+ * Two arms, because they cover different regimes and neither covers both:
+ *
+ * - Painted area, in CSS pixels² — the rule for pages. Measured against the
+ *   fixture ladder, every deliberate change covers 242 CSS px² or more while
+ *   every no-op covers exactly 0, so the floor sits in a wide empty band. CSS
+ *   pixels rather than device pixels so it means the same at --scale 1 as at
+ *   --scale 2; the old device-pixel constant was silently four times stricter
+ *   at scale 1, and at ~10 CSS px² amounted to a third of one letter.
+ * - Share of the canvas — the rule for small images. One pixel of a 20x20 icon
+ *   is a quarter of a percent of it and obviously a change, but it will never
+ *   reach an area floor sized for pages.
+ *
+ * On a full page the ratio arm effectively never fires on its own (a recoloured
+ * 16px icon is 0.024% of one), and on a small image the area arm never does.
+ * Dropping either one loses real changes, which is the worse error: reporting
+ * "no visual changes" on a PR that changed something is the one answer that
+ * makes a reviewer stop looking.
+ */
+export function isChanged(diff, opts) {
+    if (diff.changedPixels === 0)
+        return false;
+    return diff.changedPixels / (opts.scale * opts.scale) >= opts.minChangedArea
+        || diff.changedRatio >= opts.threshold;
+}
+/** "shifted down 48px" — the direction spelled out, because the sign is not. */
+export function describeShift(px) {
+    const rounded = Math.round(Math.abs(px));
+    return `shifted ${px < 0 ? 'up' : 'down'} ${rounded}px`;
+}
+function describeError(err, side, url) {
+    if (err instanceof HttpStatusError)
+        return authHint(err);
+    if (err instanceof NavigationError) {
+        switch (err.kind) {
+            case 'refused': return `connection refused at ${url} (is the ${side === 'after' ? 'dev server' : 'site'} running?)`;
+            case 'timeout': return `timed out loading ${url}`;
+            case 'dns': return `cannot resolve ${hostOf(url)}`;
+            default: return `${side}: ${err.message.slice(0, 160)}`;
+        }
+    }
+    const msg = err?.message || String(err);
+    return `${side}: ${msg.split('\n')[0].slice(0, 160)}`;
+}
+/** Did this side reach the site, or a wall standing in front of it? */
+function blockedSide(requested, result, side) {
+    const landing = checkLanding(requested, result.finalUrl ?? requested, result.title ?? '');
+    return landing.blocked ? { side, finalUrl: landing.finalUrl, vercel: Boolean(result.vercel) } : null;
+}
+async function runTask(task, opts, pool) {
+    const started = Date.now();
+    const base = { route: task.route, resolvedRoute: task.resolvedRoute, viewport: task.viewport, status: 'error' };
+    const captureOpts = {
+        viewport: task.size,
+        fullPage: opts.fullPage,
+        maxHeight: opts.maxHeight,
+        scale: opts.scale,
+        wait: opts.wait,
+        auth: opts.auth,
+    };
+    const [beforeRes, afterRes] = await Promise.allSettled([
+        captureScreenshot(task.beforeUrl, captureOpts),
+        captureScreenshot(task.afterUrl, captureOpts),
+    ]);
+    if (beforeRes.status === 'rejected' || afterRes.status === 'rejected') {
+        const errors = [];
+        if (beforeRes.status === 'rejected')
+            errors.push(describeError(beforeRes.reason, 'before', task.beforeUrl));
+        if (afterRes.status === 'rejected')
+            errors.push(describeError(afterRes.reason, 'after', task.afterUrl));
+        return { ...base, error: errors.join('; '), durationMs: Date.now() - started };
+    }
+    const before = beforeRes.value;
+    const after = afterRes.value;
+    // A sign-in wall answers with 200, so both captures "succeeded" — of a login
+    // page. Diffing those and calling the result a visual change is the failure
+    // this check exists to prevent, so nothing is compared when either side is
+    // walled.
+    const blocked = blockedSide(task.beforeUrl, before, 'before') ?? blockedSide(task.afterUrl, after, 'after');
+    if (blocked) {
+        const label = blocked.side === 'before' ? 'Pre' : 'Post';
+        return {
+            ...base,
+            blocked,
+            error: `${label} landed on a sign-in page (${blocked.finalUrl}), so the site was never captured`,
+            durationMs: Date.now() - started,
+        };
+    }
+    if (before.status === 404 && after.status === 404) {
+        return { ...base, error: `404 on both ${task.beforeUrl} and ${task.afterUrl} (wrong route or missing sample?)`, durationMs: Date.now() - started };
+    }
+    const prefix = `${routeSlug(task.route)}-${task.viewport}`;
+    const file = (kind) => path.join(opts.outputDir, `${prefix}-${kind}.png`);
+    const outputs = { before: file('pre'), after: file('post'), diff: file('diff'), cropBefore: file('pre-crop'), cropAfter: file('post-crop') };
+    // A route that exists on only one side is not a comparison, and the moment to
+    // notice is here — before the diff, not after it in a footnote.
+    //
+    // The old path diffed anyway. For a page this branch adds, "Pre" was a
+    // screenshot of the baseline's 404 and the percentage measured the distance
+    // between an error page and a new one: 10.81% for a coloured box on white,
+    // 0.05% for a light-grey one, neither a fact about the change. Worse, both
+    // numbers were published as a Pre/Post pair, so a reviewer was shown a
+    // comparison that never existed and four images where one was true.
+    //
+    // Nothing can be recovered by trying harder — a page the baseline does not
+    // serve has no "before" to find — so the honest move is to keep the side that
+    // rendered, name why the other is missing, and skip the diff entirely.
+    const absent = absentSide(before, after);
+    if (absent) {
+        const present = absent === 'before' ? after : before;
+        const target = absent === 'before' ? outputs.after : outputs.before;
+        fs.writeFileSync(target, Buffer.from(present.image));
+        const status = absent === 'before' ? 'added' : 'removed';
+        const missingHost = hostOf(absent === 'before' ? task.beforeUrl : task.afterUrl);
+        opts.log?.(`  ${status === 'added' ? 'new     ' : 'removed '} ${task.route} @ ${task.viewport} (no ${absent === 'before' ? 'Pre' : 'Post'}, ${Date.now() - started}ms)`);
+        return {
+            ...base,
+            status,
+            files: absent === 'before' ? { after: outputs.after } : { before: outputs.before },
+            // Deliberately no changedRatio: there is nothing to take a ratio of.
+            // Deliberately no textOverlap either — a 404's wording is evidence about
+            // an error page, not about whether the two sides are the same site.
+            note: absent === 'before'
+                ? `new page — no baseline (${missingHost} returned 404)`
+                : `page removed — ${missingHost} returned 404`,
+            durationMs: Date.now() - started,
+        };
+    }
+    // Copy into standalone buffers so they can be transferred to the worker.
+    const diff = await pool.run({
+        before: new Uint8Array(before.image),
+        after: new Uint8Array(after.image),
+        outputs,
+        options: {
+            padding: 40 * opts.scale,
+            minCrop: { width: 400 * opts.scale, height: 200 * opts.scale },
+            highlightDownscale: opts.scale >= 2 ? 2 : 1,
+            highlight: false,
+        },
+    });
+    const notes = [];
+    // The 404-on-one-side cases returned above; what is left is a page both sides
+    // served with an unhappy status, which is still worth diffing and flagging.
+    if (before.status && before.status >= 400)
+        notes.push(`production returned ${before.status}`);
+    if (after.status && after.status >= 400)
+        notes.push(`local returned ${after.status}`);
+    const changed = isChanged(diff, opts);
+    // Cheap fingerprint of the baseline, kept so the run can notice a host that
+    // answers every route with the same page. See softNotFoundWarning.
+    const baselineHash = createHash('sha1').update(Buffer.from(before.image)).digest('hex');
+    // Recorded on every outcome, judged only across the whole run: one route
+    // sharing no words is a rewrite, every route sharing none is the wrong site.
+    const overlap = textOverlap(before.text ?? '', after.text ?? '');
+    const titles = titleOverlap(before.title ?? '', after.title ?? '');
+    // A shift is measured in device pixels; everything a reader sees is in CSS
+    // pixels. Whether anything changed besides the move is judged by the same
+    // rule as any other capture, against the aligned numbers.
+    const shift = diff.shift
+        ? {
+            px: diff.shift.dy / opts.scale,
+            otherChange: isChanged({ changedPixels: diff.shift.alignedChangedPixels, changedRatio: diff.shift.alignedChangedRatio }, opts),
+        }
+        : undefined;
+    const shiftNote = shift ? `${describeShift(shift.px)}, ` : '';
+    opts.log?.(`  ${changed ? 'changed ' : 'same    '} ${task.route} @ ${task.viewport} (${shiftNote}${(diff.changedRatio * 100).toFixed(2)}%, ${Date.now() - started}ms)`);
+    return {
+        ...base,
+        status: changed ? 'changed' : 'unchanged',
+        baselineHash,
+        changedRatio: diff.changedRatio,
+        sizeChanged: diff.sizeChanged,
+        textOverlap: overlap,
+        titleOverlap: titles,
+        shift,
+        files: {
+            before: outputs.before,
+            after: outputs.after,
+            diff: diff.hasHighlight ? outputs.diff : undefined,
+            cropBefore: diff.hasCrop ? outputs.cropBefore : undefined,
+            cropAfter: diff.hasCrop ? outputs.cropAfter : undefined,
+        },
+        note: notes.join('; ') || undefined,
+        durationMs: Date.now() - started,
+    };
+}
+/**
+ * Did this run compare the two sites, or something standing in front of them?
+ *
+ * This lives beside the code that produces the evidence, not in the command
+ * that happens to want it. Both checks used to be written out in `pr`, and
+ * `compare` — the other caller of this pipeline — therefore had neither, and
+ * would print a confident percentage for two unrelated sites. Returning the
+ * verdict with the outcomes makes that omission impossible to repeat: a caller
+ * cannot get the numbers without also being handed the reason not to trust
+ * them.
+ *
+ * Order matters. A wall is the more specific diagnosis and has the more
+ * actionable fix, and a walled run also looks like two different sites — the
+ * sign-in page shares no words with the site — so it is answered first.
+ */
+/**
+ * Which side, if either, does not have this page at all.
+ *
+ * The signal is the HTTP status, not the page's wording. A 404 status is a fact
+ * the server states about the route; the string "404" in the body is just text,
+ * and it is present on pages that are merely *about* error codes and absent
+ * from every custom or localised not-found page ever shipped. Sniffing for it
+ * would mean this tool's own marketing page — which shows a 404 in a mockup —
+ * could be mistaken for a missing route.
+ *
+ * Soft 404s (a not-found view served with status 200, the usual SPA shape) are
+ * therefore invisible here by design; they are caught at the run level instead,
+ * where identical baselines across unrelated routes give them away.
+ */
+function absentSide(before, after) {
+    const gone = (c) => c.status === 404;
+    const served = (c) => !c.status || c.status < 400;
+    if (gone(before) && served(after))
+        return 'before';
+    if (gone(after) && served(before))
+        return 'after';
+    return null;
+}
+/**
+ * Did the baseline answer unrelated routes with the same page?
+ *
+ * This is the soft 404 — a not-found view served with status 200, which no
+ * status check can see and which a keyword hunt for "404" would catch only in
+ * English, only when the page says it, and only when no real page happens to
+ * mention it. The durable signal is not the wording but the sameness: a host
+ * that returns pixel-identical bytes for several different routes is serving a
+ * catch-all, and every comparison against it is measuring the distance from
+ * that catch-all rather than from the page.
+ *
+ * It warns rather than reclassifies. Two routes can legitimately render the
+ * same page, and silently turning a real diff into "new page" on a heuristic
+ * would hide exactly the change this tool exists to show. The authoritative
+ * signal (a 404 status) acts; this one only tells the reader what it sees.
+ */
+export function softNotFoundWarning(outcomes, beforeUrl) {
+    const routesByHash = new Map();
+    for (const o of outcomes) {
+        if (!o.baselineHash)
+            continue;
+        const seen = routesByHash.get(o.baselineHash) ?? new Set();
+        seen.add(o.route);
+        routesByHash.set(o.baselineHash, seen);
+    }
+    let worst = null;
+    for (const routes of routesByHash.values()) {
+        if (routes.size > 1 && (!worst || routes.size > worst.size))
+            worst = routes;
+    }
+    if (!worst)
+        return null;
+    const shown = [...worst].sort().slice(0, 4).join(', ');
+    const more = worst.size > 4 ? `, and ${worst.size - 4} more` : '';
+    return `Note: ${hostOf(beforeUrl)} served an identical page for ${worst.size} routes (${shown}${more}). `
+        + 'If that is a catch-all or a not-found page, those comparisons are against it, not against the real baseline.';
+}
+export function verdictFor(outcomes, sides) {
+    // Every route walled means the run never saw the site. Publishing anything
+    // from that, "no visual changes" included, would be a confident lie.
+    const walled = outcomes.filter(o => o.blocked);
+    if (walled.length > 0 && walled.length === outcomes.length) {
+        const { side, vercel } = walled[0].blocked;
+        return { kind: 'walled', hint: signInHint(side === 'before' ? sides.before.url : sides.after.url, vercel) };
+    }
+    if (looksLikeDifferentSites(outcomes)) {
+        return { kind: 'different-sites', hint: differentSitesHint(sides.before.url, sides.before.detail, sides.after.url, sides.fix) };
+    }
+    return null;
+}
+export async function runTasks(tasks, opts) {
+    fs.mkdirSync(opts.outputDir, { recursive: true });
+    const pool = new DiffPool();
+    let outcomes;
+    try {
+        outcomes = await Promise.all(tasks.map(t => runTask(t, opts, pool)));
+    }
+    finally {
+        await pool.close();
+    }
+    // Falling back to the first task's URLs keeps the verdict available to a
+    // caller that never resolved a pair — `compare`, given two URLs by hand.
+    const sides = opts.sides ?? {
+        before: { url: tasks[0]?.beforeUrl ?? '' },
+        after: { url: tasks[0]?.afterUrl ?? '' },
+    };
+    const softNotFound = softNotFoundWarning(outcomes, sides.before.url);
+    if (softNotFound)
+        opts.log?.(softNotFound);
+    return { outcomes, verdict: verdictFor(outcomes, sides) };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAW,MAAM,UAAU,CAAC;AA4D3C,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/F,OAAO,IAAI,IAAI,MAAM,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,SAAS,CACvB,IAAqD,EACrD,IAAkE;IAElE,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc;WACvE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC;AAC1D,CAAC;AAED,SAAS,aAAa,CAAC,GAAY,EAAE,IAAwB,EAAE,GAAW;IACxE,IAAI,GAAG,YAAY,eAAe;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;QACnC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,SAAS,CAAC,CAAC,OAAO,yBAAyB,GAAG,YAAY,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC;YACpH,KAAK,SAAS,CAAC,CAAC,OAAO,qBAAqB,GAAG,EAAE,CAAC;YAClD,KAAK,KAAK,CAAC,CAAC,OAAO,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAI,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,uEAAuE;AACvE,SAAS,WAAW,CAAC,SAAiB,EAAE,MAAqB,EAAE,IAAwB;IACrF,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1F,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAiB,EAAE,IAAqB,EAAE,IAAc;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAwB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACrI,MAAM,WAAW,GAAG;QAClB,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IAEF,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QACrD,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;QAC9C,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;KAC9C,CAAC,CAAC;IACH,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACtE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5G,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxG,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAE7B,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,UAAU;IACV,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5G,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzD,OAAO;YACL,GAAG,IAAI;YACP,OAAO;YACP,KAAK,EAAE,GAAG,KAAK,8BAA8B,OAAO,CAAC,QAAQ,mCAAmC;YAChG,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SACjC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,eAAe,IAAI,CAAC,SAAS,QAAQ,IAAI,CAAC,QAAQ,mCAAmC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IACrJ,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,IAAI,IAAI,MAAM,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;IAE7I,8EAA8E;IAC9E,gEAAgE;IAChE,EAAE;IACF,uEAAuE;IACvE,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,uEAAuE;IACvE,oEAAoE;IACpE,EAAE;IACF,2EAA2E;IAC3E,8EAA8E;IAC9E,uEAAuE;IACvE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACpE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,QAAQ,QAAQ,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,KAAK,CAAC,CAAC;QACzK,OAAO;YACL,GAAG,IAAI;YACP,MAAM;YACN,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAClF,qEAAqE;YACrE,yEAAyE;YACzE,oEAAoE;YACpE,IAAI,EAAE,MAAM,KAAK,QAAQ;gBACvB,CAAC,CAAC,2BAA2B,WAAW,gBAAgB;gBACxD,CAAC,CAAC,kBAAkB,WAAW,eAAe;YAChD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SACjC,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;QAC1B,MAAM,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QACpC,KAAK,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;QAClC,OAAO;QACP,OAAO,EAAE;YACP,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK;YACxB,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE;YAC9D,kBAAkB,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,SAAS,EAAE,KAAK;SACjB;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,8EAA8E;IAC9E,4EAA4E;IAC5E,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9F,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,4EAA4E;IAC5E,mEAAmE;IACnE,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxF,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACnE,2EAA2E;IAC3E,0EAA0E;IAC1E,0DAA0D;IAC1D,MAAM,KAAK,GAA2B,IAAI,CAAC,KAAK;QAC9C,CAAC,CAAC;YACE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK;YAC9B,WAAW,EAAE,SAAS,CACpB,EAAE,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAChG,IAAI,CACL;SACF;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,QAAQ,KAAK,SAAS,GAAG,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,KAAK,CAAC,CAAC;IACxK,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;QACzC,YAAY;QACZ,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,MAAM;QACpB,KAAK;QACL,KAAK,EAAE;YACL,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAClD,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACzD,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SACxD;QACD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;QACnC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH;;;;;;;;;;;;;GAaG;AACH,SAAS,UAAU,CAAC,MAAqB,EAAE,KAAoB;IAC7D,MAAM,IAAI,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC;IACpD,MAAM,MAAM,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA+B,EAAE,SAAiB;IACpF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,YAAY;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QACnE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAClB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,GAAuB,IAAI,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAAE,KAAK,GAAG,MAAM,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,OAAO,SAAS,MAAM,CAAC,SAAS,CAAC,iCAAiC,KAAK,CAAC,IAAI,YAAY,KAAK,GAAG,IAAI,KAAK;UACrG,8GAA8G,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAA+B,EAAE,KAAe;IACzE,2EAA2E;IAC3E,qEAAqE;IACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3D,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,OAAQ,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;IAC9G,CAAC;IACD,IAAI,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAClI,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB,EAAE,IAAqB;IACxE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,IAAI,QAA+B,CAAC;IACpC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;QAC1B,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,EAAE,EAAE;QAC1C,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE;KACzC,CAAC;IACF,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,YAAY;QAAE,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/sameness.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Are the two sides the same site at all?
+ *
+ * The backstop this file exists to be was first specified as "a diff near 100%
+ * on every route means the two sides are different sites". Measured, that rule
+ * is wrong in both directions, and it is worth writing down why so it is not
+ * proposed again:
+ *
+ * | pair                                            | changed |
+ * |-------------------------------------------------|---------|
+ * | the marketing site vs an unrelated real site     |  2.66% desktop / 5.02% mobile |
+ * | fixture pricing page vs an unrelated fixture     |  0.72% – 7.99% |
+ * | the same site with a full theme change (fixture) | 99.14%  |
+ * | the same site redesigned (fixture rung-7)        | 99.60%  |
+ *
+ * Web pages are mostly background, and a pixel diff counts pixels that differ,
+ * so two *unrelated* pages agree on most of the canvas and read as a small
+ * change — the same 1-8% band as the login-page run that started all of this
+ * (4.53% / 1.99%). Meanwhile a legitimate redesign, the PR most worth
+ * screenshotting, reads ~100%. A threshold at 100% would have missed every
+ * real occurrence and fired on the best ones.
+ *
+ * What does separate them is the words on the page. A redesign changes how a
+ * page looks, not what it says; a different site says something else entirely.
+ * Measured over the same pairs, with common English words removed:
+ *
+ *   different sites   0.000, 0.000, 0.000, 0.071
+ *   same site         0.200 (the weakest fixture), 0.417+, 1.000 for real pages
+ *
+ * The floor below sits in that empty band.
+ */
+/** The distinctive words a page shows a reader. */
+export declare function pageWords(text: string): Set<string>;
+/**
+ * A page with almost nothing to say cannot answer this question: an image or a
+ * canvas with six words on it scores near zero against anything, including
+ * itself one version later. Below this many distinct words, the answer is "do
+ * not know" rather than "different".
+ */
+export declare const MIN_WORDS = 10;
+/** The floor, from the measurements above: 0.071 was different, 0.200 was not. */
+export declare const SAME_SITE_FLOOR = 0.1;
+/** Overlap of two pages' body text, or null when either is too text-poor to judge. */
+export declare function textOverlap(before: string, after: string): number | null;
+/**
+ * Overlap of two pages' titles, or null when either says nothing distinctive.
+ *
+ * No `MIN_WORDS` here: a title is a handful of words by nature, and it is the
+ * one place a site almost always names itself. That makes it the corroborating
+ * signal for a run with only one route to go on — a branch that rewrites a
+ * page's copy keeps the site's name in the tab, a different site does not.
+ */
+export declare function titleOverlap(before: string, after: string): number | null;
+/** What this needs from each capture: which page it was, and how the two sides compared. */
+export interface RouteEvidence {
+    route?: string;
+    textOverlap?: number | null;
+    titleOverlap?: number | null;
+}
+/**
+ * Do the captures, taken together, say these are two different sites?
+ *
+ * Every judgeable page has to disagree, and the evidence has to be about
+ * *pages*, not captures. One route shot at three viewports is one page's word
+ * list three times over; counting it as three agreeing witnesses is how a run
+ * that detected a single route — an explicit `--routes /`, or the `/` fallback
+ * when the diff names none — could reject the one thing this function's own
+ * rule permits: a branch that rewrote a page.
+ *
+ * So captures are folded per route, keeping each route's *strongest* showing of
+ * shared words, and a run with only one page to go on asks the title as well. A
+ * title is where a site names itself, so a rewritten page keeps it and a
+ * different site does not. Without a usable title there is no second witness
+ * and the run is published, which is the right way to be wrong here: publishing
+ * a diff someone can look at beats refusing to on one page's say-so.
+ */
+export declare function looksLikeDifferentSites(routes: RouteEvidence[]): boolean;
+/**
+ * The one sentence a human needs when the two sides are not the same site.
+ *
+ * `beforeDetail` is how Pre was chosen ("production deployment for 26aa6cd"),
+ * absent when a caller was handed both URLs by hand and has no provenance to
+ * report. `fix` is the remedy, which is the caller's to name: telling someone
+ * to pass `--before` is right when the tool picked the baseline and wrong in
+ * the two-URL mode, where both sides came in as positional arguments and that
+ * flag is not how the command is invoked. Advice that does not apply to the
+ * mode you are in is the failure this project keeps finding — it is what sent
+ * someone to sign in to a macOS system service.
+ */
+export declare function differentSitesHint(beforeUrl: string, beforeDetail: string | undefined, afterUrl: string, fix?: string): string;
+//# sourceMappingURL=sameness.d.ts.map

package/dist/sameness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sameness.d.ts","sourceRoot":"","sources":["../src/sameness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAeH,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAGnD;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,kFAAkF;AAClF,eAAO,MAAM,eAAe,MAAM,CAAC;AAgBnC,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzE;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAkBxE;AAYD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAoC,GACxC,MAAM,CAGR"}